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PREFACE 


This manual is the prime docioment for the BOSS XVM(BOSS) Batch Oper- 
ating Software System and describes its features, concepts, language 
and operating procedures. The first four chapters provide a general 
description of the BOSS System components, both hardware and software, 
and fundamental system concepts. Brief descriptions of all system 
programs with applicable document numbers are contained in Chapter 4. 

The remaining four chapters deal with the BOSS System at a more tech- 
nical level. They are primarily concerned with the syntactical 
structure and operation of the batch commands. The job control lan- 
guage is presented in Chapter 6. The information in this chapter is 
given in a reference format with each command in alphabetical order. 

The information in these chapters is directed primarily to readers 
who are familiar with either the FORTRAN IV language or the DIGITAL 
XVM(XVM) assembly language, MACRO XVM (MACRO) . FORTRAN I/O consider- 
ations are specifically covered in the FORTRAN IV Operating Environ- 
ment Manual. In addition, there are special BOSS commands for the 
Peripheral Interchange Program (PIP) . 

A quick reference summary of PIP command strings, operating procedures, 
error messages and string examples is provided in Appendix A. 

Detailed information on the operations of the XVM/DOS Monitor and its 
file structure as well as interactive operating procedures for pre- 
paring user-created applications via XVM/DOS software are provided 
in the XVM/DOS Users Manual. 

The XVM/DOS Keyboard Command Guide contains a chapter of reference 
information on BOSS XVM. 
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CHAPTER 1 
INTRODUCTION 


1.1 BATCH OPERATING SYSTEM 

BOSS XVM(BOSS) is the DIGITAL XVM(XVM) Batch Operating System Software. 
It is a dedicated (stand-alone) Job-System Interface residing with the 
Disk Operating System XVM/DOS (DOS) in a "DUOPS" configuration (see 
Figure 1-1) . BOSS is a general purpose scientific, commercial, and 
applications programming package designed for computational centers 
in private industry and universities. 

BOSS is a comprehensive Batch system with a full range of source and 
run-time software facilities including languages and peripheral I/O 
Device Handlers. Its multi- job management includes Job Accounting 
and Line Editing Features. The System's card resident Command Lan- 
guage incorporates Peripheral Interchange, Editing, and Job Control 
functions . 

Batch is a method of serial computer program processing which max- 
imizes the number of programs that can be run in a given time. It 
optimizes cyclical non-interactive application tasks, since jobs can 
easily be prepared and desk-checked off-line. 

1.2 DUAL OPERATING ENVIRONMENTS 

The system required for a BOSS user contains both the standard 
XVM/DOS software, communicating with the DOS Monitor, and the batch 
oriented software, communicating with the BOSS Monitor. Files con- 
structed by either operating system are compatible in both. 

1.2.1 Disk System 

The Disk Operating System is an interactive environment under console 
keyboard control. A DOS command "BOSS " is used to load the batch 
software . 
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Introduction 


1.2.2 Batch System 

Batch Operating System Software (BOSS) controls a batch environment 
exclusively through the use of BOSS command cards. An End-Of-File- 
Card is required at the end of a job deck to reenter DOS software. 

The program features of both environments are illustrated in Figure 
1 - 1 . 

1 . 3 BOSS XVM 

BOSS is a disk-resident batch operating system. It is a set of pro- 
grams supervised by a Monitor. The Monitor tailors the system con- 
figuration according to the BOSS Command Language card, and then 
supervises operation of the system or user programs requested by con- 
trol cards. The set of programs called BOSS XVM provides powerful 
I/O capabilities and programming tools that include: 

Program Preparation 
Compilation 
Assembly 
Debugging 

Execution of User Program.s and 
Job Process Accounting 

Chapter 4 presents the various programs available to the BOSS user. 
For detailed information about any of these programs, the user should 
refer to the appropriate manual. 

1.3.1 System Features 

BOSS offers all the I/O power available in DOS 

o Substantial device independence 

o I/O in a variety of data modes 

o Powerful I/O macros that initialize the device, search 

for files, open and close files, and take care of all 
I/O transfers and device interrupts, 
o A special file structure suitable for efficient use of 

disk storage space 

o Dynamic disk storage allocation 

o Dynamic buffer allocation 

o A simplified file protection scheme for disk files 
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o Random access to physical disk records and, using FORTRAN 

routines, random access to logical disk records, 
o The number of simultaneously open disk files limited only 

by available buffer space and the number of logical device 
slots assigned to the disk 

o Spooled data to/from slow UNIBUS peripherals onto the RK05 

system-resident disk to increase throughput. 

In addition, BOSS has added the following features: 

o Job accounting facilities 

o Line editing 

o A procedure-file-driven command language which is: 

1 . Open-ended 

2. User-modifiable 

o The Batch Control Language resides on an 80 column card 

in a "free-flowing" format. 


^UC15 


systems only 
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CHAPTER 2 
CARD CONVENTIONS 


2.1 CARD PUNCHING 

The basic operating unit within the BOSS batch job stream is the 
punched card. This card contains data to be interpreted as system 
control information, user source coding and run-time data. It is a 
standard eighty column card using the Hollerith Card Code format. 
Oi'iginal data is transcribed (e.g., from accounting forms and program 
coding forms etc.) to punched cards from any of several types of "Key 
Punch" equipment. 

2.1.1 Hollerith Card Format 

The Hollerith card has 80 columns and 12 rows. The columns are num- 
bered 1 through 80. Ten rows are identified by numbers j? through 
9. The remaining two rows, "11" and "12", are not marked. Along with 
the "0" row, they make up the zone rows. Each column on the card can 
be used to record one numeric, alphabetic, or special character. 

2.1.2 Hollerith Card Code 

The Hollerith card is used to code alphanumeric characters into com- 
puter-usable data. An alphabetic character is represented by a numer- 
ic and a zone overpunch in one column. As shown in Figure 2-1, the 
twelve rows are used to represent 26 alphabetic characters, 10 decimal 
digits, and certain special symbols. 

2. 1.2.1 Digits - The digits are recorded by punching a single hole in 
the corresponding digit or zero position of the desired column. 

2. 1.2. 2 Alphabetic Characters - A letter is a combination of one 
zone punch and one digit punch in the desired column. For example, 

A is 12-zone and digit-1 punches, N is 11-zone and digit-5 punches, 
and Z is 0-zone (zero) and digit— 9 punches. 
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Figure 2-1 
DEC 029 Card Code 

2. 1.2. 3 Special Characters - A special character is one, two, or 
three holes in the desired column as shown in Figure 2-1. Punching 
two or three holes in one column for a letter or special character is 
generally automatic when the corresponding key is pressed. Numbers are 
represented in columns 6 through 15, letters in columns 22 through 46, 
and special characters in columns 54 through 78. 

2.2 DIGITAL XVM ASCII/HOLLERITH CORRESPONDENCE 

The BOSS Character Set represented in Table 2-1, shows the corres- 
pondence between the XVM 64 character graphic subset of ASCII and the 
DEC029/026 Hollerith codes. The 029 code, except as indicated by 
brackets []. is a subset of the standard Hollerith punched card code 
specified in ANSI standard X3. 26-1970. Parentheses denote 1963 
character set. The following special conditions should be noted. 

1. ASCII codes 00-21 and 140-177 have no corresponding 
codes in the DEC026 and 029 Hollerith sets, and, there- 
fore, are not presented here. 

2. ALT MODE is simulated by a 12-8-1 punch {multipunch A8) . 

3. End-of-File corresponds to a 12-11-0-1 punch (multi- 
punch A0-) in column 1. 

4. Back-arrow (•*-) is simulated by: 0-8-5 multipunch in 
029 code,* 8-2 multipunch in 026 code. 
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5. The card reader hardware supplies the binary equivalent 
of Hollerith code which, in turn is mapped into 7-bit 
ASCII by the Card Reader Handler. 

6. For UC15 Systems, a special end of spooled deck card 
is necessary to force all the card images through the 
PIREX monitor buffers and onto the spooled area on the 
disk. 

The format of this card is an ALT Mode in column 1 and 
an ALT mode in column 2. (12-8-1, 12-8-1). 

One of these cards should follow in every deck (applies 
to only unichannel system.s with card reader spooling 
enabled) . 

2 . 3 CARD COMMANDS 


The card commands used to control one or more jobs in a user's input 
deck are shown in Figure 2-2. The reader should refer to Chapters 5 
and 6 for information concerning the BOSS command language syntax 
and individual command structure. 
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TABLE 2-1 

BOSS CHARACTER SET 
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Figure 2-2 BOSS Card Commands 
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CHAPTER 3 

SYSTEM HARDWARE ENVIRONMENT 


3 . 1 INTRODUCTION 

The Batch Operating System Software is defined within the limits of a 
specified DIGITAL XVM/PDP-15 hardware system configuration; i.e., 
central processor model, minimum and maximum core requirement, nec- 
essary features, and types and numbers of peripheral devices. 

In order to run the BOSS XVM portion of the XVM/DOS system, the min- 
imum hardware requirements include a card reader and a line printer. 

3.2 MINIMUM HARDWARE REQUIREMENTS 

For a DIGITAL XVM System: ^ 

KP15 Central Processor 
24,576 Words of 18 Bit Memory 

2 

LA36, LA30C, KSR33, KSR35 or VT05 Console Terminal 
PCI 5 High-Speed Paper Tape Reader/Punch 
KE15 Extended Arithmetic Element 
KW15 Real-Time Clock 

9 

XM-15 Memory System including: 

Wide Addressing 

Memory Protection and Relocation 
Instruction Prefetch 
Automatic Priority Interrupt 

4 

TC15 DECtape Control with 1 TU56 Dual DECtape Transport ; or 

TC59 Magtape Control with 1 TUIO, TU20 or TU30 (7- or 9-track) 

Magtape Transport 

RK15 Cartridge Disk System with RK05 Cartridge Disk Drive and 8,192 
Words of 16-bit Core Memory^; or 

RP15 Disk Pack Control with one RP02 or RP03^ Disk Pack Drive; or 
RF15 DECdisk Control with two RS09 DECdisk drives. 
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CRll Card Reader or CR15 Card Reader or CR03B Card Reader. 

LPll Line Printer or LSll Line Printer or LVll Electro Static 
Printer; or 

LP15 Line Printer 

For a PDP-15 Computer System: 

KP15 Central Processor 

24,576 Words of 18 -bit Core Memory 

2 

KSR35, KSR33, LA30C, LA36 or VT05 Console Terminal 
PCI 5 High-Speed Paper Tape Reader/Punch 
KE15 Extended Arithmetic Element 
KW15 Real-Time Clock 

KA15 Automatic Priority Interrupt (required only for RK15 systems in 
certain configurations) ^ 

4 

TC15 DECtape control with one TU56 Dual-DECtape transport , or 

TC59 Magtape Control with one TUIO, TU20 or TU30 (7- or 9-track) 
Magtape Transport 

RF15 DECdisk Control with two RS09 DECdisk drives; or 

RP15 Disk Pack Control with one RP02/RP03^ Disk Pack Drive; or 

RK15 Cartridge Disk System with one RK05 Cartridge Disk Drive and 
8,192 Words of 16-bit Core Memory^ 

CR15 Card Reader or CRll Card Reader or CR03B Card Reader 

DP15 Line Printer or LPll Line Printer or LSll Line Printer or 

LVll Electrostatic Printer 

3.3 OPTIONAL HARDWARE SUPPORTED 

For the DIGITAL XVM:^ 

CR15/CR11/CR03B Card Readers 

, > 6 

Core Memory 16-bit (12K) 

Core Memory 18-bit (ME15, MF15) (32K to 128K)^ 

TC15/4 TU56 Dual DECtape or TC02/8 TU55 DECtape 

RF15/8 RS09 Disk 

RK15/8 RK05 Disk Cartridge^ 

RP15/8 RP02/RP03 Disk Packs^ 

FP15 Floating Point Processor 

1 VT15/1 (VT04 or VT07)/1 VL04 Graphics Display 
LP11/LP15/LS11/LV11^ Line Printer 
TC59/8 (TU10/TU20/TU30) Magtape 
XY11/XY311^ Plotter 
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VP15A Storage Scope 

LA36/LA30C/KSR33/ASR33/KSR35/ASR35/VT05/LK3S'^' ^Terminal 
1 VWOl Writing Tablet 

For the PDP-15: 

XM-15 Memory Processing Unit including: 

Wide Addressing 

Memory Protection and Relocation 
Instruction Prefetch 
Automatic Priority Interrupt 

KA15 Automatic Priority Interrupt 
CR03B/CR15/CR11^ Card Reader 
Core Memory 16-bit (12K)^ 

Core Memory 18-bit (MM15/MK15/ME15/MF15) (32K to 128K) ^ 

TC15/4 TU56 or TC02/8 TU55 DECtape 

RF15/8 RS09 Disk 

RK15/8 RK05 Disk Cartridge^ 

RP15/8 (RP02/RP03) Disk Pack 
FP15 Floating Point Processor 

1 VT15/1 (VT04 or VT07)/1 VL04 Graphics Display 
LP15/LP11/LS11/LV11^ Line Printer 
TC59/8 (TU10/TU20/TU30) Magtape 
XY11/XY311^ Plotter 
VP15A Storage Scope 

KSR33/KSR35/ASR33/ASR35/LA30C/LA36/VT05/LK3S’^' ^ Terminal 
1 VWOl Writing Tablet 

Notes : 

1. The RP03 Disk Pack is supported as if it were an RP02 Disk Pack. 

2. The LA36 and LA30C DECwriters and the VT05 Video Terminal are 
supported up to 300 baud. 

3. API is required if the user has more than four PDP-11 options 
which need to interrupt the PDP-15. 

4. The older style of DECtape can be used: TC02 Control with 2 
TU55 single DECtape transports. 

5. The RK15 includes within it an 8,196 word UNICHANNEL -15 peri- 
pheral processor. If the spooling software is to be used, the 
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requirement for 16-bit core memory is raised from 8,192 words to 
12,288 words, if more than two devices are to be spooled. 

6. Prerequisite hardware for devices like the CRll, LPll, LSll, 
LVll, XYll, and XY311, plus 16-bit core memory, is the RK15. 

The RK15 minimally contains a UNICHANNEL-15 with 8K words of 
16-bit memory, an RKllE Cartridge Disk Control and 1 RK05 Cart- 
ridge Disk Drive. At any given time, only one line printer, 
one card reader, and one XY plotter in the combined XVM/PDP-11 
or PDP-15/PDP-11 system is supported by the software. The LSll 
or LVll printer must be connected to the same vectors/priority 
as would the LPll. 

7. The LK35 Graphic Keyboard is not a substitute for the console 
terminal; consequently, it also requires an LT15A Single Tele- 
type Control. The paper tape facility on ASR Teletypes is not 
software supported. The LA30C and LA36 DECwriters and the VT05 
Video Terminal can be run a baud rate of up to 300. 

8. Memory configuration greater than 32K require the XM-15 options, 
and can utilize ME15 or MF15 memory only. 

9. The XM-15 hardware option is incompatible with MM-15 memory, 
KA-15 automatic priority interrupt and KM/KT-15 memory protect 
and relocate. The XM-15 hardware functionally replaces these 
options . 
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CHAPTER 4 

BOSS XVM SOFTWARE ENVIRONMENT 

4 . 1 INTRODUCTION 

This chapter gives information necessary for the user to evaluate sys- 
tem programs to be run under BOSS control. Each system program will 
assist the user in performing a particular task in the process of ap- 
plication design and implementation. Considerations for system mod- 
ification can be found in the XVM/DOS System Manual. 

4 . 2 SYSTEM SOFTWARE 

The Batch Operating System's service routines perform four primary 
tasks for all user applications (see Figure 4-1) . 

1. Run-Time Aids - External routines from several libraries are 
available to the user. The libraries miay contain either 
user-designed routines or those provided by DOS which can be 
implicitly or explicitly called. 

2. General Utilities - BOSS provides facilities for efficient 
storage, flow, and retrieval of system and user data. There 
are also system features that provide file verification and 
data buffer allocation, file data manipulation, etc. 

3. Program Preparation and Maintenance - There are system pro- 
grams to aid user program preparation by modifying file text 
for source programs and programs to aid maintenance of object 
programs . 

4. Language Assembly and Compilation - Programs are available 
to translate problem-oriented and procedure-oriented lan- 
guages into miachine language and to incorporate routines into 
complete, executable programs. 

4.2.1 Choice of Languages 

User source programs can be implemented at two levels depending on 
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Figure 4-1 BOSS XVM Software System 
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those particular system features required for a given processing en- 
vironment. BOSS supports the following levels of automation for object 
program preparation: 

1. Compiler level language - FORTRAN IV (called via the $FOR 
card) , 

2. Assembly language - MACRO (called via the $ASM card) . 

3. PDP-11 Assembly language - MACll (called via the $MAC11 card). 

4. 2. 1.1 FORTRAN IV Compiler - The XVM FORTRAN is a higher-level lan- 
guage system that accepts statements written in the FORTRAN IV language 
and produces a relocatable object program which can be loaded with 
either the Loader or with CHAIN/EXECUTE. The XVM FORTRAN IV is based 
on the language of USA Standard FORTRAN (X3. 9-1966). The FORTRAN 
system consists of the FORTRAN IV compiler and an Object Time System 
(OTS) . 

Subroutines written in FORTRAN IV, or MACRO assembly language can be 
loaded with and called by FORTRAN IV main programs. Comprehensive 
source language diagnostics are produced during compilation. The sys- 
tem's Data-Directed Input-Output package permits input or output of 
ASCII data without reference to a FORMAT statement. The system can 
also perform memory-to-memory transfers (Encode/Decode) , moving data 
from memory to the I/O Buffer, to memory. 

BOSS supports two versions of the FORTRAN compiler. The non-floating 
point version, F4M, and its OTS, perform floating point operations by 
generating software calls to subroutines. The hardware floating point 
version, FPF4M, and its OTS support the optional FP-15 hardware by 
generating floating point instructions. 

A FORTRAN IV program may be compiled and run in several different 
hardware environments. The FORTRAN programmer need not be too con- 
cerned with the details of his environment since the FORTRAI^ Object- 
Time System (OTS) will ensure that his source statements generate the 
appropriate computer instructions. For example, an arithmetic state- 
ment such as A=A*B will appear the same in any FORTRAN IV program. 

In the object program it may be transformed to a subroutine call or a 
floating point instruction, depending on the hardware configuration 
on which the program is produced. FORTRAN data-transmission state- 
ments automatically call a number of OTS subroutines which serve as 
an interface between the user program and the Monitor. These routines 
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may also be called from MACRO assembly language programs. Further, 
programs written in FORTRAN IV can be linked to programs or routines 
written in the MACRO assembly language. 

For more information concerning this higher-level programming language, 
refer to the FORTRAN IV XVM Language Manual and the FORTRAN IV XVM 
Operating Environment Manual . 

4. 2. 1.2 MACRO XVM Assembler - The MACRO XVM Assembler provides users 
with highly sophisticated macro generating and calling facilities with- 
in the context of a symbolic assembler. MACRO permits the programmer 
to use mnemonic symbols to represent instruction operation codes, lo- 
cations, and numeric quantities. It simplifies the handling of recur- 
ring instruction sequences through its macro instruction feature. This 
feature permits the user to represent these instruction sequences with 
a single source statement. Some of the prominent features of MACRO 
include : 

1. The ability to: 

(a) define macros 

(b) define macros within macros (nesting) 

(c) redefine macros (in or out of macro definitions) 

(d) call macros within macro definitions 

(e) have macros call themselves (recursion) 

(f) combine up to three input files for one assembly 

2. Conditional assembly based on the computational results of 
symbols or expressions. 

3. The ability to repeat a generated word of output. 

4. Boolean expressions. 

5. Optional octal, symbolic, and cross-reference listings. 

6. Two forms of radix control (octal, decimal), and two text 
modes (ASCII and 6-bit trimmed ASCII) . 

7. Global symcbols for easy linking of separately assembled pro- 
grams . 
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8. Choice of output format: relocatable, absolute binary (check- 
summed) , or full binary — capable of being loaded via the 
hardware READIN switch. 

9. Ability to utilize user-designed input/output macros. 

10. A Table of Contents option containing the page numbers and 
text of all assembled .TITLE statements in the program. 

11. The ability to combine up to three separate input files for 
one assembly. 

12. The ability to use an external file of system, m.acros. 

Refer to the MACRO XVM Assembler Language Manual for a complete de- 
scription of the language. 

The standard object code produced by MACRO XVM is in a relocatable 
format which is acceptable to the CHAIN utility program. Relocatable 
programs that are assembled separately and use identical global sym- 
bols^ where applicable, can also be combined by CHAIN into an execut- 
able program. 

An output listing, showing both the programmer's source coding and 
the binary object program produced by MACRO is printed if desired. 

This listing includes all the symbols used by the programmer with their 
assigned values. If assembly errors are detected, erroneous lines are 
marked with specific letter error codes. 

2 

4. 2. 1.3 MACll Assembler - This MACRO Assembler (MACll) provides 
the user of the UNICHANNEL-15 system with the capability of assembling 
the full repertoire of the PDP-11/20 instruction set. Besides making 
the UC15 system self-sufficient it provides the users with highly 
sophisticated macro operating and calling facilities within the context 
of a symbolic assembler. Some notable features of MACll are: 

1. The ability to: 

(a) define macros. 


Symbols which are referenced in one program and defined in another. 

2 

Only for UC15 systems. 
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(b) Define macros within macros (nesting) , 

(c) Redefine macros (in or out of macro definition) 

(d) call macros within macro definition 

(e) provide alternate exit points from macros (particularly 
nested macros) 

(f) pass arguments (numeric and non-numeric) and compute the 
number of arguments passed 

(g) provide built in error reporting capability in a macro 

2. Create automatic local labels. 

3. Concatenate strings. 

4. Generate indefinite and definite repeat blocks. 

5. Conditional assembly based on the computational results of 
symbols or expressions. 

6. Two forms of radix control (octal, decimal) and three text 
modes (ASCII, ASCIZ and 6-bit ASCII). 

7. Ability to utilize user designed input/output macros. 

8. Use local and non-local labels. 

9. Provide table of contents containing the page numbers, text 
of all assembled .TITLE statements in the program and the 
line numbers on an output listing. 

MACll permits the programmer to use mnemonic symbols to represent in- 
struction operation codes, locations, and numeric quantities. It is 
essentially a comprehensive macro instruction generator. This gen- 
erator permits easy handling of recursive instruction sequences, chan- 
ging only the arguments. 

The assembler facilitates the development of instructions called 
"macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. Refer 
to the MACll-XVM Assembler Language Manual for a complete description 
of the language. 
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The only object code produced by MACll is in an absolute format on 
paper tape. 

An output listing, showing both the programmer's source coding and 
the binary object program produced by MACll, is printed if desired. 

This listing includes all the symbols used by the programmer with their 
assigned values. If assembly errors are detected, erroneous lines are 
marked with specific letter error codes. 

4.2.2 XVM/DOS System Generator (SGEN XVM) 

SGEN XVM (SGEN) is a DOS Utility program used to modify disk resident 
system files. It is not part of the BOSS run-time environment. It is 
available only in the DOS interactive mode. SGEN is provided as part 
of the general-purpose package. It enables the user to tailor his sys- 
tem and add to the supplied software in order to develop a resident 
software system unique to the installation or to his specific needs. 


The System Manager calls the system generator program via the Monitor 
command "SGEN". When SGEN is loaded, it initiates an interactive ques- 
tion/answer sequence regarding the following system functions and para- 
meters . 

1 . Options 

2. Type of printer unit used 

3. Required device handler designations (i.e., the standard I/O 
configuration the user wants for the system programs 

4. Skip-Chain information - Priority Interrupt Skip Chain 
contents and order 

5. Default assumptions 

6. System device designation 

7. .DAT slot assignments 

8. Monitor Identification Code to designate the privileged 
access to the System Manager 
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9. Default buffers that are needed at any time during a user 
program, 

10. Default Files Protection Code. 

Careful planning is necessary to ensure that the most efficient system 
will be developed for the user's particular needs. For more information, 
refer to the SGEN XVM Utility Manual. 

4.2.3 CHAIN XVM and EXECUTE XVM Programs 

These programs permit the BOSS user to load and execute his FORTRAN IV 
and MACRO object programs. CHAIN XVM (CHAIN) relocates segments and 
constructs a system of core overlays in an easy and straightforward 
manner . 


CHAIN also reserves portions of user core (called COMMON blocks) from 
one segment to another so that the program segments can communicate. 

The FORTRAN IV compiler and the MACRO assembler can reserve COMMON 
BLOCKS for future segmentation. This method of segmentation permits 
multiple overlays of executable code, constants, variables, arrays, 
and labeled COMMON blocks. 

In addition, CHAIN organizes subroutines into units called LINKS, which 
may overlay each other. Several LINKS may overlay a larger LINK with- 
out overlaying each other. A LINK is loaded into core when a subroutine 
\^j_-t;^bin the LINK is called via the $LNK card, and remains resident until 
overlayed. A LINK'S core image is not recorded or "swapped out" when 
it is overlayed. The same image is brought into core each time a LINK 
is loaded. For maximum run-time efficiency, segments must be processed 
serially. CHAIN is called by the $MAP or $OVL command. 

EXECUTE XVM (EXECUTE) is a control program which initiates loading of 
the absolute (XCT/XCU) files created by CHAIN and supervises the trans- 
fer of control from one segment chain to another. The $XCT command is 
used to execute the executable file previously created by use of the 
$MAP or $0VL commands . 

The $XCT card initiates EXECUTE operation. EXECUTE is a loader-monitor 
that runs the program files created by CHAIN. See the CHAIN XVM/EXECUTE 
XVM Utility Manual for detailed instructions. 
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4.2.4 DUMP XVM Program 

DUMP XVM (DUMP) gives the user the ability to output, on any device 
specified, core locations that have been preserved on disk via the 
$DMP and $QDP commands. For more information refer to the $DMP Section 
in Chapter 6. 

4.2.5 Peripheral Interchange Program (PIP XVM) 

PIP XVM (PIP) can transfer data files from any input device to any out- 
put device. It can also be used to: 

1. Refresh file directories, 

2. List file directory contents, 

3. Delete, insert, segment, or combine files, 

4. Perform code conversions, 

5. Assign protection codes, 

6. Transfer files, or 

7. Copy the entire contents of disk and tape storage units. 

It may also be used to update and allocate restricted disk storage 
surfaces. Refer to the PIP XVM Utility Manual for additional infor- 
mation. 

4.2.6 BOSS Preprocessor (B.PRE) 

The system program B.PRE is a "Line Editor" used to preprocess MACRO 
and FORTRAN source files. It can also be used for any disk resident 
ASCII file. The Line Editor permits the user to insert, delete, and 
substitute file lines. For more information, refer to the Line 
Editor Section in Chapter 5. 

4.2.7 UPDATE XVM - Library Update Program 

This system program gives the user the capability to examine, extract, 
and update the binary library files on mass storage devices. The 
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UPDATE XVM program is called via the $LIB card and must be followed by 
the $LCM command functions. For more information, refer to the UPDATE 
XVM Utility Manual. 

4.2.8 SRCCOM XVM - Source Compare Program 

The SRCCOM XVM program compares any two symbolic source programs (ASCII) 
and indicates their differences. It is called via the $CMP card. This 
program is useful for program identification and/or verification, proof- 
ing an edited program, comparison of old and new versions of the same 
program, etc. For more information, refer to the SRCCOM XVM Utility 
Manual . 

4.3 BOSS XVM CONCEPTS AND FACILITIES 

BOSS XVM (BOSS) is a general purpose batch processing system. It pro- 
vides the user with the ability to use system programs and the disk 
file structure of DOS. The exceptions are those programs that work 
only in an interactive environment. The user makes use of the system 
facilities via a batch, card-oriented control language. BOSS permits 
a hands-off environment. 

The typical installation that runs BOSS has a computer operator. The 
operator receives a job from a user in the form of a card deck. He 
runs the job, and returns to the user the input card deck and the line 
printer output with information pertaining to that run. The operator 
also has access to a tape bank. If a job requires the use of tape 
(either DECtape or magtape) the user can instruct the operator to mount 
the desired tape(s) through a special "message" control ($MNT) card 
which is part of the BOSS command language. 

The general purpose facilities of BOSS include; 

1. A comprehensive disk file structure with random access and 
protection. 

2. A line editor for card oriented on-line file updating. 

3. A fast overlay scheme. 

4. User created library files. 
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5. An accounting capability. 

6. A job timer. 

The user can operate with only five control cards: 

$JOB 

$FOR 

$MAP 

$XCT 

$END or EOF 

added to his FORTRAN source deck and data cards. He can compile and 
execute one or more FORTRAN programs (one main program plus one or 
more subprograms) . For additional power, the user has at his disposal 
many variations on each control card which allow him to make use of any 
DOS facility. 

Another feature of BOSS gives the system programmer in charge of a 
BOSS installation the ability to modify the command language. He can 
accomplish this without having to interrupt operations. BOSS achieves 
this through its "procedure driven command language". Each BOSS com- 
mand has an associated ASCII file which describes the action of the 
command in terms of DOS commands. This file is called the Procedure 
File. Procedure Files permit rapid modification of the BOSS command 
language to suit installation needs using simple editing procedures. 

The command name and the name of its Procedure File have to coincide 
to create the association between them. 

4.3.1 BOSS File Structure 

BOSS disk file structure and file operations are identical to DOS I/O 
and file operations. The Monitor makes the association between logical 
and physical devices via the Device Assignment Table^. At run time, 
the user assigns handlers those .DAT slots via the $ASG command, and 
the Monitor loads the handlers along with the user's program. Chap- 


^The size of the .DAT is determined at system generation time, and may 
have as many as 76 ^q — 15g negative and 77g positive — entries. 
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ters 4 and 6 of the XVM/DOS User's Manual describe the characteristics 
of Monitor I/O operations for devices other than the disk. 

Additional BOSS facilities are described in the following paragraphs. 

4.3.2 Disk File Structure 

The following is a description of the DOS file structure used with 
BOSS and the changes this structure makes to operations and procedures. 
Ordinarily, each disk user has a directory which points to named files. 
The disk has as many directories as users have cared to establish. The 
number of files associated with any one directory on a disk is limited 
only by the available space. 

Since the disk may have a variable number of directories, the Monitor 
must know how to find each user's directory. It therefore maintains a 
Master File Directory (MFD) at a known location^, and the Master File 
Directory points to each User File Directory (UFD) . BOSS allows only 
those users who know a special code, called the Monitor Identification 
Code (MIC) and use the $MIC command, to have access to the MFD. Fig- 
ure 4-2, Master File Directory, illustrates the organization of the 
MFD. 

4, 3. 2.1 User Identification Codes (UIC) - The Monitor finds User 
File Directories by seeking associated User Identification Codes (UICs) 
which are all listed in the Master File Directory. The UIC is a three- 
character code that is necessary for all directory oriented I/O to 
Directory. (Non-directory oriented I/O to the disk, i.e., TRAN macros, 
use no directory references.) A programmer may operate under as many 
UICs as he wishes, provided all are unique and none is reserved 
He may establish a new User File Directory by (1) logging in his new 
UIC to the Monitor via the $LOG command and (2) by issuing a $N DK 
command. This establishes a new User File Directory, or refreshes 
(wipes clean) an old directory under that UIC. (During user program 
operation, .ENTER will also create a new MFD entry and/or a UFD, if 
none exists.) Figure 4-3, User File Directory, illustrates the organ- 
ization of a UFD. 


^On the RF and RK disks, the first block of the MFD is located at 
block 1777. 

On the RP disk, the first block of the MFD is located at block 47040. 

2 

The following are reserved UICs: (§@@, ???, PAG, BNK, SYS, lOS, CTP, 
PER. 
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Figure 4-2 

Master File Directory 


Word 

1 

Contents 

Description 

8N 

•SIXBT 

Name of this file 

8N+1 

.SIXBT 

and its 

8N+2 

•SIXBT 

Extension 

8N+3 

Tw+blknum 

0 

Truncation code in bit 0, plus the number of the 
first block of the file 

8N+4 

nnnnnn 

Number of blocks in this file 

8N+5 

ribptr 

Pointer to the first block of the Retrieval In- 
formation Block 

8N+6 

.+ribwrd 

0-1 

Protection code in bits 0-1, plus the first word 
in ribptr used by the RIB — if the last block of 
the file has room for the RIB, the handlers will 
put it there, and load word 8N+6 accordingly. 

8N+7 

crdate 

Date of file's creation -mmddyy (yy modulo 70) 

376 

nnnnnn 

Pointer to previous block, or 777777 if none 

377 

nnnnnn 

Pointer to next UFD block, or 777777 if none 


Figure 4-3 
User File Directory 


Bits 0-1 of word 374 are concatenated with bits 0-1 of word 375 to pro- 
duce a 4-bit checksum for the 16-bit fields of words 374 and 375. Check- 
sum = word 374 (2-17) + word 375 (2-17) + 1. 
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4. 3. 2. 2 The User File Directory Table (.UFDT) - The Monitor must have 
a way of knowing which User File Directory to reference when a program 
issues I/O commands to the disk. It makes the association between disk 
I/O commands and User File Directories by using a User File Directory 
Table (.UFDT) . There are as many entries in the User File Directory 
Table as there are slots in the Device Assignment Table. Figure 4-4, 
Relationship Between the .DAT and the .UFDT, shows how the two compare. 
Disk I/O to a particular .DAT slot will affect files in the User File 
Directory named in the corresponding .UFDT slot. Unless modified during 
System Generation, the default value in each .UFDT slot is SCR, for 
Scratch (except in those slots reserved for the system, -2, -3, +5, +6 
and -7) . Whenever a user issues a LOGIN command to the Monitor, the 
Monitor automatically assigns the three-character code ponched after 
$LOG to each .UFDT slot with the SCR default. 

The user may modify the .UFDT via the $ASG command card. This allows 
program I/O to operate on files listed under a UFD that is not associ- 
ated with the UIC current^ to the system. If the operator has not 
changed the .UFDT via the $ASG command, the program may issue a .USER 
command to the appropriate .UFDT slot. The system will then enter the 
desired UIC into the proper .UFDT slot. The program can then operate 
on files listed by that User File Directory, according to the protection 
codes specified. 

4. 3. 2. 3 File Protection - BOSS offers a simplified form of file pro- 
tection. Each User File Directory has a protection code (optionally 
specified in commands to PIP) , and each file has a protection code 
(optionally specified in the .ENTER command, via the $PRT command, or 
a command to PIP) . The protection codes are in effect only when a 
program tries to reference a file listed under a UIC other than the 
one currently logged in to the system. If a User File Directory is 
protected, then the protection codes for each file are in effect. If 
the User File Directory has been specified as unprotected, then no 
protection is provided for any file in the directory. There are three 
protection states possible for files in a protected User File Directory: 

Protection code = 1 Unprotected, with the exception that the 

file may not be deleted and the number of 
blocks may not change, if the directory is 
protected. 


^The 


"current" UIC is the one logged in to the Monitor. 
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Protection code = 2 Write protected, if directory protected. 
Protection code = 3 Read/Write protected, if directory protected. 

User File Directories may have one of two protection states: 

Protection code = 0 Unprotected 

Protection code = 1 Protected 

The default protection code for User File Directories is always 1. The 
default protection code for files is established at system generation 
time. Users may change the file default protection code via the $PRT 
command to the Monitor. Whatever code is specified in a $PRT command 
will remain the default code until a $DLG (logout) or a new $PRT com- 
mand is received. (See $PRT command in Chapter 6.) 

The $N DK command to PIP allows the user to set the protection of the 

L— I 

User File Directory, and the $R. .DK command to PIP allows the user 
to change that protection. The .ENTER I/O macro establishes a file's 
protection code. The only way to dynamically change a file's protec- 
tion code is by recopying the file. Note that the disk handlers do 
not protect the user from, himself. 

File protection codes may be changed by using the RENAME COMMAND: 

R DK FILE SRC*-DK FILE SRC(#) 

Where # is one of three possible protection codes for files in a pro- 
tected UFD (see above) . 

4.4 ORGANIZATION OF SPECIFIC FILES ON DISK 

Disk file blocks have forward and backward links, and upon receipt of 
a .CLOSE I/O macro, the disk handlers fill out a Retrieval Information 
Block (RIB) . The RIB indicates which blocks the file occupies, and 
also associates the logical sequence of blocks in the file with the 
physical locations of the blocks on the disk. The disk handler uses 
the RIB to implement .RTRAN commands and to delete files. Figure 4-5, 
the Retrieval Information Block, illustrates a RIB. 

After a user has created a disk file, he can access logical records 
sequentially via .READ commands, and physical records (blocks) of that 
file by referencing relative block numbers in the .RTRAN command. 
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DAT/UFDT Number 

DAT Contents 

UFDT Contents 

Comment 

+N 

nondisk handler 

UIC^ 

This UIC is 
irrelevant 

+2 

DKA 

UIC^ 

I/O to this 
slot will go 
to files in 
UIC^ 

+1 

DPA 

UIC2 

I/O to this 
slot will go 
to files in 

UIC2 

-15 

NON 

UIC^ 

This UIC is 
irrelevant 


The user has logged in under UIC-. . He has assigned some nondisk 
handler to DAT+N, the DECdisk to^DAT+2 , and the Disk Pack unit pf 
to DAT+1, and NON (no handler) to DAT -15. In addition, he has 
changed the UFDT assignment for UFDT+1 to UIC^ . I/O to DAT+N will 
not reference the UIC, since UICs are relevant to disk I/O. I/O 
to DAT+2 will reference UIC, , while I/O to DAT+1 will reference 
UIC 2 . The UIC for DAT -15 '^is irrelevant, since no handler is 
assigned. 


Figure 4-4 Relationship Between the DAT and the UFDT 


WORD # Contents Description 


0 

nnnnnn 

Total number of blocks described by this 
RIB. (The RIB need not start in word ^ 
of its block. See Figure 4 - 3 , User File 
Directory. ) 

1 

nnnnnn 

First data block pointer 

2 


Second data block pointer 

3 

. 

Third data block pointer 

376 

nnnnnn 

Pointer to previous RIB block or -1 if 
no previous RIB block. 

377 

nnnnnn 

Pointer to next RIB block or -1 if no 
next RIB block. 


Figure 4-5 Retrieval Information Block 
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The .RTRAN commands require the file be opened with the .RAND command. 

The .RTRAN command allows the user to read or write any block in a file 
on a disk pack or disk cartridge and any word in a file on the DECdisk. 
The user is prohibited, however, from changing the total number of blocks 
in the file. Thus, insertion and deletion of blocks is only accomplished 
by recopying the file. 

The FORTRAN IV OTS file routines allow random access at the logical rec- 
ord level (as opposed to the physical block level) for any file with 
fixed-length records. lOPS binary records may be as long as desired, 
when using these routines. For more information, see FORTRAN IV XVM 
Operating Environment Manual . 

4.5 THE DISK HANDLERS 

The disk handlers allow as many concurrently open input or output files 
as there are .DAT slots available to the user, and buffers available to 
the disk handler. The disk handlers operate under a dynamic buffer al- 
location scheme. Whenever the Monitor loads a system or user program, 
it allocates buffer space. This space is called the buffer pool. When- 
ever a program opens a disk file, the handler obtains a buffer from the 
buffer pool. It will return the buffer when the program closes the file. 

The BOSS Monitor determines the amount of buffer space from two .SCOM 
registers and adds one for the RTF file. One register, .SCOM+27 con- 
tains the standard buffer size, as determined at system generation time. 
The other, .SCOM+26, contains the number of buffers to be allocated. 

The user can set the number of buffers needed for the next program by 
using the $BUF command. When the Non-resident Monitor returns, it will 
restore the number of buffers in .SCOM+26 to a value set at system gen- 
eration time unless the user issued a $KEP command. 

The buffers in the buffer pool are available to programs, as well as 
to disk handlers. A program may use .GTBUF and .GVBUF to obtain and 
return a buffer from the pool. The $BUF command card is used to tem- 
porarily change buffer default values for disk I/O and for the .GVBUF 
and .GTBUF requests. Whenever a program is using a buffer, however, it 
is unavailable to any other program. 

Three handlers each are provided for operations with the RF15 DECdisk, 
and RP02 Disk Pack and the RK05 Disk Cartridge. Version for version. 
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these handlers are identical in their functions with these two excep- 
tions : 

a. VJhile all three types of disks are block addressable for 
direct access operations (.TRAN and .RTRAN macros), the DECdisk 
in addition provides word addressability via .RTRAN macros. 

b. The Disk Pack and Disk Cartridge have a unit structure while 
the DECdisk does not. This means that each DECdisk is treated 
as a single addressable unit regardless of the actual number 
of platters incorporated (up to 8) , but separate Disk Pack and 
Disk Cartridge units are only separately addressable. 

The handlers operate in all data modes (i.e., lOPS, Image, and Dump) . 

A list of the I/O Macros which are acceptable to the various handler 
versions can be found in the XVM/DOS Users Manual. 

4.6 XVM/DOS I/O MACROS 

Table 4-1, Synopsis of XVM/DOS I/O Macros, is a summary of the I/O 
macros which the DOS Monitor recognizes. The disk random access com- 
mands are .RAND and .RTRAN. All commands are described in the XVM/ 

DOS Users Manual. 

4.7 ERROR PROCESSING 

The Nonresident Monitor's INSTRUCT ERRORS printout (via $DOS I ERRORS) 
indicates the information given with each error message. In BOSS, all 
errors are terminal, except lOPS 4. This means that the operator may 
type CTRL R to recover from lOPS 4 error only. Error messages are out- 
put to the Line Printer and the Job Accounting File. On terminal errors 
the current job is aborted and the System searches for the next job 
($JOB) . Provisions to dump core via the $DMP, $JOB, or $QDP commands 
may be included in the job string. 


4.8 BOSS XVM ACCOUNTING 

BOSS has a very simple accounting mechanism. BOSS keeps an account 
record for each job in a random access file in the CTP User File 
Directory. CTP is protected, and can only be accessed after successful 
execution of a $MIC command. 
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SYNOPSIS OF XVM/DOS I/O MACROS 


Macro 

Function 

. CLEAR 

Initializes a directory on a directoried mass storage 
device^ . All data on the device is lost and fresh bit 
maps and directories are written. 

. CLOSE ^ 

Terminates use of a file. In the case of output files 
on the disk, fills out the Retrieval Information Block 
Crib) for later .RTRAN commands. 

. DLETE^ 

Deletes a file from a directory on a mass storage 
device . 

.ENTER 

Primes a directoried mass storage device to accept an 
output file. 

.FSTAT 

Checks directory on a mass storage device for refer- 
ence to the named file. 

. INIT^ 

Initializes the device and device handler. 

. MTAPE 

Provides special commands for industry compatible 
magnetic tape. 

.RAND 

Opens a disk for random processing via .RTRAN macros. 

.READ 

Transfers a logical record, or the requested number 
of words, whichever is smaller, from the device to 
the user's I/O buffer. 

.RENAM^ 

Renames a file in a directory of a mass storage device. 

.RTRAN 

Allows input and output to access to any block in a 
pre-existent file on the disk (any word if RF) . 

. SEEK 

Checks for a named file in a directory on a mass 
storage device. If file is present, prepares it as 
an input file. 

.TRAN 

Gives independence from DOS-15 file structure by 
allowing input and output access to magtape, or to 
any block on disk or DECtape located by its physical 
block number. 

.WAIT 

Waits for I/O already started to complete, then 
continues . 

.WAITR 

Waits for I/O already started to complete, then con- 
tinues. If I/O not done, passes control to speci- 
fied address. 

.WRITE 

Transfers data from user's I/O buffer to device. 


^At completion of these operations, the buffer is given back to 
the buffer pool, if disk I/O. 

CLEAR initializes the MFD directory when directed to a disk 
storage device. 
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The name of the accounting file is ACCNTG nnn; the first file has an 
extension of 001. Each file is ten physical blocks long and contains 
enough information for 310 jobs, thirty-one per physical block. See 
Table 4-2. When the file ACCNTG 001 is filled up, its extension is 
changed to 002 and a new file ACCNTG 001 is started. A third file 
makes the second become ACCNTG 003 and so on. Therefore, the current 
accounting file always has the extension 001, and the oldest, 002. 

Every time a job ends, BOSS checks the status of the ACCNTG 001 file. 

If it exists, BOSS checks to see if it is full. If not full, a new 
entry is made in ACCNTG 001. If all extension numbers have been used 
(up to 777) , BOSS prints this message to the operator on the teleprinter: 


MAX NUMBER OF ACCOUNTING FILES REACHED 
PLEASE PROCESS AND DELETE THEM 


Every time the system manager processes an accounting file he should 
delete the file. The BOSS system only creates accounting files. It 
does not provide a program for processing them. 


TABLE 4-2 

ACCOUNTING FILE RECORD STORAGE 


Blocks/File 
Records/Block 
Record = 8 words 

Where: 1 - 

3 = ID code 


4 = DATE mm dd yy 

5 = START TIME hh mm ss 

6 = FINISH TIME hh mm ss 

7 = RUN TIME hh mm ss 

8 = JOB TERMINATION STATUS 


4.8.1 Accounting File Record 

For each completed job, BOSS writes out an 8— word record to the account- 
ing file. The records have the following format: 


WORD # 


CONTENT 


1 

2 

3 

4 

5 

6 

7 

8 


Job I.D. 
in 

.SIXBT 

Date, packed mmddyy 
Start Time, in hhmmss 
End Time, in hhmmss 
Run Time, in hhmmss 
Terminal Job Status Word 


.. j 


WULU WilU&C wcii uo 


777777 
8 


jdiately follows the last job 


accounting record in each physical block of the accounting file. 
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CHAPTER 5 
LANGUAGE SYNTAX 


5 . 1 INTRODUCTION 

The batch language, as implemented by BOSS XVM, provides user control 
over a group of programs, routines, and data placed together for the 
purpose of processing as a single operating unit. Control of this 
operation is accomplished through parameters carried on special system 
command cards. The rules governing each parameter within a particular 
command- string structure are called the "language syntax". This sec- 
tion will outline the language, define the syntax, and specify those 
command functions used to edit and manipulate data. 

5 . 2 LANGUAGE COMMANDS 

BOSS XVM has a flexible command language with all the capabilities of 
the XVM/DOS System.. Each language command, with its functional de- 
scription, is given in Table 5-1. A detailed description of each com- 
mand is given in Chapter 8. 

The BOSS XVM Command Language (BCL) has generally three types of com- 
mands as follows: 

1. Special function commands, 

2. Commands that call system programs, 

3. Peripheral Interchange Program (PIP) commands. 

Two of these command functions are illustrated in a simple BOSS XVM 
job string example shown in Figure 5-1. 



Figure 5-1 

A BOSS XVM Job String Example 
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Table 5-1 

BOSS Command Language 


COMMANDS 

FUNCTIONS 

$ 

End-of-File Card for both Control and Data Files. 

$$ 

End-of-ADDf ile Card terminating a CRT file 

$* 

Continuation Card (Field continuation & Field Set addition) . 


Editor Command Card for Insertion, Deletion & Substitution. 

$ADD 

Add contents of file to input stream. 

$ASG 

Device correspondence, assign Device UIC to DAT. 

$ASM 

MJiCRO Assembler. 

$B 

Block copy (System Manager only) . 

$BNK 

Enter BANK mode operation. 

$BUF 

Buffer Specification. 

$c 

Copy Mass Storage. 

$CHN 

Specify 7- or 9-Track magtape. 

$CMP 

SRCCOM, Source Compare Utility. 

$CRT 

Create ADD File. 

$D 

Delete file from user File Directory (UFD) . 

$DIR 

List directory. 

$DLG 

LOGout UIC. 

$DMP 

Dump core upon terminal error. 

$DOS 

General Command string. 

$END 

End job. 

$FIL 

Create a file from cards. 

$FOR 

FORTRAN IV. 

$I 

Initialize, restore MFD. 

$JOB 

Begin a job. 

$KEP 

Retain device assignment. 

$L 

Initialize, restores MFD (System Manager only) . 

$LCM 

Update Function. 

$LIB 

Update Command (Library Utility Program) . 

$LNK 

Chain Link specification. 

$LOG 

LOGIN UIC. 

$LST 

List contents of file on line printer. 

$MAC11 

MACll assembler 

$NIAP 

Chain Absolute File with/without overlays. 

$MIC 

LOGIN MIC (Not echoed) . 

$MNT 

Tape mount message. 

$MSG 

Message to the operator. 

$MSW 

Message to the operator with Wait. 

$N 

New directory (UFD) . 

$NDR 

Create new directory. 

$OVL 

Chain with overlays. 

$PAG 

Enter PAGE mode operation. 

$PRT 

Change file protection code. 

$QDP 

Dump Core on lOPS Error 

$R 

Rename file and/or change protection codes. 

$RUN 

FORTRAN compile, chain, and execute. 

$s 

Segment file into various members. 

$T 

Transfer files between I/O devices. 

$u 

Update bad allocation (BAT) and storage (SAT) tables. 

$V 

Verify files for Parity or Checksum. 

$XCT 

Execute. 

$XVM 

Enable or disable XVM mode for user programs. 

(@) @) 

1 2 

End of deck card for spooled operations. ' 

12-11-J2I-1 

Terminate BOSS run and return to XVM/DOS card. 


i!'or systems with kK 05 storage devices only. 

2 

ALT is a 12-8-1 multipunch. 

3 

12 - 11 - 0-1 is a multipunch in column 1 of the card. 
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5.2.1 Special Function Commands 


The special function 

commands provide those control 

parameters to be 

used in directing the 

operation of System software. 

These commands 

are as follows: 



$ADD 

$DOS 

$MNT 

$ASG 

$END 

$MSG 

$BNK 

$FIL 

$MSW 

$BUF 

$JOB 

$NDR 

$CHN 

$KEP 

$PAG 

$CRT 

$LOG 

$PRT 

$DIR 

$LST 

$QDP 

$DLG 

$MIC 

$XVM 


5.2.2 System Program Load Commands 

Commands that load System programs are as follows: 


$ASM 

$LCM 

$MAP 

$CMP 

$LIB 

$OVL 

$DMP 

$LNK 

$RUN 

$FOR 

$MACII 

$XCT 


5.2.3 Peripheral Interchange Program Commands 

The PIP - BOSS utility commands enable the system user to perform the 
following functions via card-resident commands to: interchange in- 

formation, perform data verification and modification, establish, view 
and modify file directories. The basic PIP commands are as follows: 


$B 

$L 

$T 

$c 

$N 

$u 

$D 

$R 

$v 

$I 

$s 



5.3 INTRODUCTION TO BOSS SYNTAX 


The batch control language resides on eighty-column Hollerith punched 
cards in a BOSS syntax. The general command syntax, to be covered in 
this chapter, must be followed in order to run a job string without 
error . 


In this syntax, all BOSS commands have a "$" sign in column one of 
the control card. All cards beginning with this character are assumed 
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by the system to be control cards. The general syntactical form of 
a command with its parameter string is: 

$COMMAND; OPTIONS ARGUMENT-1; .... ;ARGUMENT-N 

This command string is divided into specific fields which are delimited 
by field separators. The delimiters used are punctuation characters 
and block card columns. 

The command field must contain one of the initial set of commands 
supplied with the BOSS System (see Table 5-1) . 

The option field can contain any legal BOSS parameter as given in a 
particular BOSS command format. Refer to Chapter 6 information con- 
cerning a specific command. 

The argument field can be composed of three sub-fields as follows: 

1. Filename and Extension, 

2. Device, Handler and Unit Number, 

3. User Identification Code. 

These sub-fields comprise a "field set". The recurrence of a field set, 
presented above as ARGUMENT-N, should occur less than or equal to ten 
(<10) times within the command string. 

For each BOSS command, there corresponds a disk-resident ASCII file 
called a Procedure File. The Procedure File contains XVM/DOS commands. 
When BOSS executes the commands in the Procedure File, it carries out 
the DOS function specified by the BOSS control card. The Procedure File 
specifies where to substitute arguments from the control card. This 
internal process is illustrated in Figure 5-2 "Procedure File Concept". 

A more detailed discussion of this process will be covered in Chapter 8. 

Procedure File expansion is very similar to a macro expansion, where: 

1. The DOS commands are the assemibler language, 

2. The BOSS command name is the macro name, 

3. The contents of the BOSS control card are the macro arguments, 
and 

4. The Procedure File is the macro definition. 

The expanded DOS commands are put in a disk file called the "Run Time" 
File, stored under the file name PRCFIL PRC. The BOSS Command Language 
is essentially an open-ended language since the user can add to it by 
defining his own Procedure Files. 
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Figure 5-2 Procedure File Concept 


5 . 4 CONTROL CARD GENERAL FORMAT 


In order to ensure successful expansion of the information on control 
cards into a series of executable commands, all command strings 
must follow one of three formats: 


1. Expanded Substitution, 

2. Direct Substitution, 

3. Peripheral Interchange (PIP). PIP commands via 
BOSS are identical to DOS PIP commands except 
for the "$" in column one of the card. 

The rules for these formats can be found in the following sections 
of this chapter. 

The following general symbology is used, for documentation purposes, 
to indicate to the user options within the command string: 

[] = Square Brackets - indicate optional quantities, 

{ } = Braces - indicate a choice of one 

5.4.1 Expanded Substitution Card Format 

The general command card format required for an Expanded Substitu- 
tion File is organized with the following basic elements (see Figure 
5-3) . 

5. 4. 1.1 Command String Field Delimiters - Command string field 
delimiters are found in Table 5-3. 
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Expanded Substitution Format: 


j $cmd I [ ; option] 


Com- L 

mand ^ 



filenm[t_,ext]l Jddvu] Field Field 

r I * 1 r I M r M I-**!' 

xxxxxxxxxx J , [xxxjd I Ixxjd I J?1 j?9 


Field Set 


Fields 




Field filenm 

Set ( s ) 


Command Field - This field must be preceded by a dollar sign 
where : 

Command $ = Command Card. It must appear in column one. When 

used alone it acts as an End-of-File card. 

cmd = Control Commands (3 alphabetic characters) . Refer 
to Chapter 6. 

option — One to six alphanumeric characters denoting specific 
options where required (refer to individual com- 
mands) . 

Field filenm = A six character file-name plus a qualifying three 

Sst(s) character subfield, or 

ext = A three character file-name extension (e.g., SRC, 
or ^ BIN, ABS, etc.). 

X - X = A ten character field. 

Note: Extension subfield within "A" field is delimited 

by a blank ( , ,) if number of characters preceding 
are >0 and _<6; otherwise, go to next field. 

ddvu = Device (dd) , handler version (v) , and unit number 

or i f 

xxxx = A four character field. 

uic = User Identification Code, or 
or C 

XXX = A three character field. 

String ; = An Option field or the recurrence of Field Set 

delimiters [Ann: Dnn (Unn) ] . All intervening Field Set 

semicolons are required prior to the last 
recurrence of a Field Set. A semicolon following 
the last Field Set indicates additional set(s) 
to follow on a Continuation Card. 

$ = Command field (contains any one command of the BOSS 

Command Language, see Table 5-1) . 

' = Blank space (card column) and A00 field delimiter, 

: = "D" Field delimiter, 

"U" Field delimiters. 


ddvu 


UlC 

or C 

XXX 


string 

Delimiters 
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5. 4. 1.2 Command String Reserved Characters - In the command 
strings for both Expanded Substitution and Direct Substitution, 
certain characters must not be used within user supplied parameters, 
e.g., options, file-names, device-type or UIC) . These reserved 
characters are given in Table 5-2. 

Table 5-2 


Special Control Card Reserved Characters 


Type of 
Substitution 

System Reserved Characters 

[ 

& 


r 

( 

) 

Direct 


S 


X 



Expanded 

v/ 


X 

X 

X 

X 


where: X = Field Delimiters. 

S = Special - starts next line in RTF. 
/ Internal Terminator (code 333 ) . 
blank = Character may be used. 


5.4.2 Fields 

There are five basic fields within an expanded substitution command 
string: 

1. Command Field 

2. Option Field 

3. Address Field 

4. Device Field (DJ?^) 

5. User Identification Field 

5. 4. 2.1 Command Field - The Command Field is a required field 
determined by a dollar ($) sign in column one of the card. In 
Figure 5-3, "cmd" indicates a user selection of one BOSS command 
(see Table 5-1) . It must be 3 non-blank alphameric characters for 
the Expanded Substitution format. 
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5.4.2. 2 Option Field 

OPTIONS - One to six alphameric characters specifying options for 
the command. The first character of the Options Field must be in 
column 6. The Options Field is delimited by a "SEMICOLON" in column 
5 and a "BLANK" in column 7,8,9/10,11, or 12. The options as defined 
for specific commands can be found in Chapter 6. 

5. 4. 2. 3 Field Set 

Field Set = [Ann : Dnn (Unn) ] 

A = Address = A00 through A09 

D = Device = D00 through D09 

U = UIC = U00 through U09 

This field has 3 subfields (described below) . The first Field Set is 
delimited by a space on the left and either column 80 or semi- 
colon on the right. FS (2) . . .FS (10) , are delimited by " ; " on left 
and either or end of card on the right. All blanks, with one 

exception (i__iext) are ignored. 

The recurrence of a Field Set [Ann: Dnn (Unn) ] is delimited by a semi- 
colon All intervening Field Set semicolons are required prior 

to the last recurrence of a Field Set. A semicolon following the 
last Field Set indicates additional set(s) to follow on a Continua- 
tion Card. 

Address Field (A00) 

Filenm ext - This optional field and subfield specifies a file 
name and the extension. The filenm ext field has two subfields, 
one of six characters and one of three characters. The first sub- 
field is delimited either by the character count (6) or by a blank; 
the second subfield is by character count (9) , by subfield character 
count (3), or by " : ". Only the first nine non-blank characters 
of this field are recognized by the Accounting File. All blanks are 
ignored in the field set. The filenm ext field contains the only 
exception to the rule. 

A default file-name is provided for within some Procedure Files. 

The user should refer to the command string of a particular job 
command to find whether the system provides a default condition. 
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Device Field (Dj2(0) 

ddvu— where: dd = device designation 

V = device handler version 

u = unit mamber (0 - 8) 

This field can be used to specify a device name and unit mamber . 

Only the first 4 non-blank characters in this field are recognized. 

The others are ignored. The ddvd field is delimited by ” : " and the 
character count (4) . The next occurrence of this field in a Proce- 
dure File would be D00 , etc. 

Unless otherwise stated by a specific command, the default assump- 
tion for this field is the System Device (e.g., DKA) . The device 
designations acceptable by the System are as follows: 

PP = Paper Tape Punch 

PR = Paper Tape Reader 

TT = Teletype 
CDB = Card Reader 
DTu = DECtape 
MTu = Magtape 
DK = DECdisk 
DPu = Diskpack 
RKu = Disk Cartridge 
LP = Line Printer 

VP = VP15A CRT display 
XY = XYll or XYll Plotter 

The device handler version has a default value of "A". Refer to the 
XVM/DOS Users Manual for more information concerning device handlers. 

An example of a user supplied parameter for this field is as 
follows : 

MTA3 

User Identification Field (U00) 

UXC - The UIC is used to specify User Identification Code. 

Only the first three non-blank characters in this field are recognized. 
The others are ignored. The UIC field is delimited by left and right 
parentheses, "(" and ")". 

The BOSS Monitor finds disk User File Directories by seeking associated 
User Identification Codes (UICs) , which are listed in the disk s 
Master File Directory. The UIC is necessary for all directory- 
oriented I/O to the disk. A programmer may identify himself ($LOG) 
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to the system with only one UIC at a time, but he may have as many 
UICs as he wishes, provided each is unique and none is reserved. 
Further, programs may simultaneously reference files under several 
different UIC's. 

On DECtape, there is only one directory for the whole tape. On 
disk, there is a central directory, called the Master File Directory 
(MFD) , but each user can have his own User File Directory (UFD) . 

The MFD points to each UFD. Each UFD is named by a unique three 
character UIC. The User File Directory Table (UFDT) is part of 
the Resident Monitor associated with the Device Assignment Table. 

It indicates the User Identification Code (UIC) associated with 
every DAT slot (i.e., each logical device via $ASG) . Disk I/O to 
a particular DAT slot will go to files in the UFD named by the cor- 
responding UFDT slot. 

5.4.3 Direct Substitution 

$cmd [A00] ; [A]2(ll ; . . . ; [A99 ] 

where Ann = An open-ended field. Its recurrence is indicated 

by a semicolon prior to the field and its continua- 
tion by a following semicolon, prior to or in the last 
card column. 

When processing a Direct Substitution Procedure File, BOSS places 
the fields on the control Card into the RTF just as they stand, with 
only leading spaces ignored. That is, BOSS does not necessarily 
expect to find file names, etc., as with normal substitution. 

Fields on the control cards are separated by semicolons (;), and 
are processed in a serial manner. 
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5.4.4 Peripheral Interchange (PIP) Command Formats 

The PIP Utility command has two general formats. Both command 
strings given below have function delimiters unique to PIP and 
are not part of the BOSS General Format. 


5. 4. 4.1 Single Device PIP Command Format 


BOSS OPERATION 

COMMAND COMMAND DEVICE FILE(S) INVOLVED OPTIONAL 

CHARACTER CHARACTERi_,MNEMONICujf ilename Ext. (-s^xTCHES 


Example : 

$ Y i_i filea^fileb ^ (A) 


Commands of this type specify PIP operations involving only a single 
device and a file or set of files. They specify the operations to be 
performed and the device involved. All switch options must be enclosed 
in parentheses. 


5. 4. 4. 2 Destination/Source Command Format 

A. Destination Parameters 
BOSS OPERATION 

COMMAND COMMAND DESTINATION DESTINATION FILE OPTION 
CHAR- CHARACTER ,_j DEVICE ( filename i_j ext )u_i SWITCHES 
ACTER 

B. Source Parameters 

SOURCE SOURCE FILE 

DEV ICE i__i (filename i_jext) 

Example : 

$T^_jDK^DESTFL,_,SRC,_, (G) ^DT^DATA^SEV 

Commands of this type are used to specify PIP operations which 
involve the transfer of data between two devices or device areas. 
Such commands consist of two sections separated by a back-arrow 
(^) delimiter. 


[Destination Source] 
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5.4.5 Peripheral Interchange Commands (PIP) 

BOSS XVM Peripheral Interchange Program commands are utility functions 
which enable the batch user to perform the following major operations 
via BOSS control cards. 

1. Establish, view, and tailor the system file directories 
utilized by BOSS for systems management. 

2. Initiate the interchange (transfer) of information between 
the disk and peripheral I/O devices. 

3. Perform verification and modification procedures on infor- 
mation being transferred. 

4. Establish, view, and modify file directories of file struc- 
tured peripheral mass storage devices. 

5. List and modify file directories of directory-oriented 
magnetic tapes. 

BOSS PIP commands are identical to XVM/DOS PIP commands except for the 
"$" in column one. Under BOSS, the BOSS Monitor accepts PIP commands 
exclusively from cards, whereas under XVM/DOS PIP operates interactively 
via the teleprinter. These commands, along with their command string 
formats and examples, are summarized in Appendix A. Further discussion 
in this section deals primarily with PIP format information. A complete 
single source of information is not intended, but summary reference 
tables are included in Appendix A (Quick Reference Tables) . A detailed 
coverage of the features provided by the utility program PIP XVM can 
be found in the PIP XVM Utility Manual. 

In PIP commands, the primary operations are identified by two characters 
(see Table 5-3, PIP Primary Operations Summary) beginning in column one 
on an eighty column card. PIP commands may be executed alone or they 
may include one or more optional functions. For example, in the command 

$T^DK-(-DTlj_jFILEA SRC 

the letter "T" specifies the transfer operation, i.e., FILEA SRC is 
to be transferred from DECtape #1 (DTI) to the current User File Direc- 
tory on the disk (DK) . The back arrow (-<-) , a multipunched character 
0-8-5, is used to point to the receiving or destination argument field. 
These elements are formulated into a PIP command string by the user 
(see Table 5-4 Command String Delimiters). The PIP delimiters should 
not be confused with the general Procedure File syntax presented earlier 
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Table 5-3 


PIP Primary Operations Summary 


The Primary: 
OPERATION 

is identified 
by the 

COMMAND CHARACTER 

and performs the 
FUNCTION 




TRANSFER 

$T 

Transfer named data files between 
peripheral I/O devices. 

VERIFY 

$v 

Check a named file for parity or 
checksum errors. 

SEGMENT 

$S 

Divide a file into a specified 
number of segments (16 maximum) 
and store each segment as a sepa- 
rate named file. 

LIST 

$L 

Provide listings of system direc- 
tories . 

NEW DIRECTORY 

$N 

Either clear an existing directory 
or, if one does not exist, estab- 
lish a new one. 

DELETE FILE 

$D 

Delete files from User File Direc- 
tories . 

RENAME 

$R 

Rename files and change protection 
codes for the file or the UFD in 
which it is listed. 

COPY, Mass 
Storage 

$c 

Copy the contents of one mass 
storage medium onto another. 

BLOCK COPY 

$B 

Copy the contents of one or more 
selected data storage blocks con- 
tained by one device onto another 
medium. Block copy to the disk 
may be performed only by the MIC 
user. 

INITIALIZE 

$I 

Enable the system manager to clear 
all disk bit maps and restore the 
MFD to its original state. This 
command may be used only by the 
MIC user. 

UPDATE 

$u 

Update the monitor's Bad Allocation 
Table (BAT) and Storage Allocation 
Table (SAT) whenever defective stor- 
age blocks are detected on the disk. 
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5. 4.5.1 Command String Elements - The basic elements which comprise 
the PIP command strings are delimiters, mnemonics, and format re- 
quirements. These elements implement the major user capabilities of- 
fered by PIP. Sub-functions and parameters, which may be carried out 
within the context of major PIP operations, are specified in the 
"Optional Functions" paragraph. 

A. Command Status Delimiters 

Delimiters are flags which are set to separate elements of a command 
string. The delimiters used in PIP commands are listed and their 
uses described in the following table. 


Table 5-4 

Command String Delimiters 


Delimiter : 

Function 

Example 

(space) 

Separate major command string 
elements 

Tt_jDKi_|FILE. . . 

(back 

arrow) 

Separate destination and 
source sections of a com- 
mand string 

dest. ■«- source 
T DK-^DTl FI LEA SRC 

: (colon) 

a) In RENAME command, sepa- 
rates UFD name from speci- 
fied UFD protection code 

b) Separate device mnemonic 
and filename 

<JAN: j2(> 
DTI :FILEA 

, ( comma ) 

a) Separate filenames within 
a command string list 

b) Specify number of tapes 
or files involved in an 
operation when names are 
not needed 

DTI FILEA, FILES, FILEC 
PR, , , (READ 3 tapes) 

; (semi- 

colon) 

Separate filename and file- 
name extension or data mode 
option 

DTI ;FILEA, FILES SRC 

<> (angle 
brackets ) 

Identify non-current UFD's 

< JOE> 

0 (paren- 
theses ) 

Identify option switches or 
specified protection codes 

(A) 

(dash) 

Separator to indicate a 
range of numbers 

100-150 
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B. Optional Functions - PIP primary operations may be executed alone 
or they may include one or more "optional functions". 

An optional function acts as a subset to one or more primary opera- 
tions. It IS used to specify parameters (such as data modes) and 
secondary operations (such as parity checks) which are to be carried 
out during the execution of the primary operation. An optional 
function IS identified by an alphabetic letter enclosed in parentheses 
which is entered as a switch in a PIP command. Switch (A), which 
specifies that lOPS ASCII data is to be handled in the performance of 
the primary operation, and switch (Y) , which indicates that a file 
segmentation operation is to be performed during the primary operation, 
are two examples of optional functions and their switches. The use of 
switch (A) in the following command: 

$T DK^DT1^ILEAj__,(A) 

specifies that the data contained by FILEA is in lOPS ASCII form. 

All PIP optional functions are listed and described in Table 5-5. 


Table 5-5 PIP Optional Functions 


OPTION 

COMMAND 

CHARACTER 

FUNCTION 

lOPS ASCII 
Data Mode 

(A) ^ 



lOPS Binary Data 
Mode 

(B) 



Image Alphanumeric 
Data Mode 

(I) 


Specifies the type of data (i.e., 
format) handled by the primary PIP 
operation. 

Dump Data Mode 

(D) 



Image Binary Data 
Mode 

(H) ^ 



Bad Parity & 
Checksum Check 
& Correction 

(G) 

Outputs error messages and the 
lines containing errors detected. 
Corrective actions are permitted. 

Tab to Space 
Conversion 

(E) 

Causes all tabs found in the data 
handled to be expanded into a 
series of spaces. 
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Table 5-5 PIP Optional Functions (Cont'd) 


OPTION C 

COMMAND 

:haracter 

FUNCTION 

Convert Multiple 
Spaces to Tabs 

(C) 

Causes each group of two or more ^ 
spaces encountered during the pri- 
mary operation to be converted to 
a TAB. 

Segment Files 

(Y) 

Indicates that the file being trans 
f erred is to be segmented. 

Combine Files 

(W) 

Combines one or more separate files 
into a single file. 

Form Feed 

(F) 

Causes a form-feed and a RETURN 
character to be inserted after the 
detection of each .EJECT statement 
or after every 55^^ lines. 

Delete Trailing 
Spaces 

(T) 

Causes all trailing spaces to be 
deleted from alphanumeric data being 
handled during the primary operation. 

Delete Sequence 
Numbers 

(Q) 

Used for punched card input, this 
option causes all input sequence 
numbers to be deleted. 

Reserve QAREA with 
New Directory 

(Snn) 

Used for DECtape devices only, this 
option initializes any existing di- 
rectory or establishes a new direc- 
tory, and causes a CTRL Q area to 
be allocated on the device. The 
size of the allocated area may be 
specified (i.e., nn) by the user. 

New Directory 

(N) 

Performs the same function as the N 
primary operation. It either clears 
an existing directory or, if one 
does not exist, establishes a new 



one . 

List MFD 

(M) 

Enables standard UIC users to ob- 
tain a listing of all unprotected 
UFD's contained by the device (disk). 
The MIC user will obtain a listing of 
all UFD's contained by the device. 

List SYSBLK 

(L) 

Enables the user to obtain a listing 
of the system SYSBLK directory. 

List UFD with 
Auxiliary Data 

(P) 

Causes file RIB data to be added 
to a UFD listing. 

Delete UFD 

(K) 

Removes UFD entry from MFD. 

Delete All 

Truncated 

Files 

(X) 

Causes all truncated files contained 
by the current or specified UFD to 
be deleted. 
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Table 5-5 PIP Optional Functions (Cont'd) 


OPTION 


COMMAND 

CHARACTER 


Vertical Forms 


FUNCTION 


Translates the first character of 
each record to a special character 
which, when interpreted by the line 
printer handler will produce forms 
control functions. The translation 
will occur according to the FORTRAN 
conventions shown below. 

Character Translated Meaning to 

Found To LP Handler 


FF, 14o 

o 

DLE, 20. 
DCl, 21 ] 
(space) LF,12-' 


anything 

else 


LF, 12 


Skip to top 
of form 
Overprint 
Double Space 
Single Space 
Single Space 


Table 5-6 Source and Object Code File Extension/BOSS Operation 


I/O CODE MODULES 


COMMAND 

OPERATIONS 

1. Language Translation 
$FOR 
$ASM 


INPUT AND 
SOURCE FILE 
EXTENSION 


Source 


Module 


OUTPUT AND 
OBJECT FILE 
EXTENSION 


Relocatable 
Object Module 


2. CHAIN Operation 
$MAP 
$OVL 
$LNK 


Relocatable to 
Module 


LOAD** 

Module Absolute 


3. Program Execution 
$XCT * 


Module 
XCU, XCT 


CORE for 
execution 


* If load module file-name has 3 characters, then $XCT FIL can be 
written as $FIL, and "FIL" must not be the same as a legal BOSS 
command . 

** Load module equals two files, one with an XCU extension, and 
the other with an XCT extension. 
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5.5 INPUT/OUTPUT CODE MODULES 

The object code produced by FORTRAN IV ($FOR) and MACRO ($ASM) is 
relocatable binary (BIN file extension) which is made absolute (XCU 
file extension) by the CHAIN operations $MAP , and $OVL. A relocatable 
object program may be loaded into any part of memory. Programs in 
absolute forms can only be loaded into or executed from the locations 
assigned by the language translator. 

The CHAIN program ($MAP or $OVL and $LNK) relocates object programs 
to create absolute executable core image files. In the process of 
creating these files, CHAIN joins programs by supplying definitions 
for global symbols (i.e., symbols which are referenced in one program 
and defined in another) thus providing a communication linkage between 
separately assembled programs. 

CHAIN outputs two files, one consisting of the executable binary of 
the programs input to it (XCU file) and the other containing control 
information (XCT file) . 

The EXECUTE program ($XCT command) is used to run the user's executable 
binary files utilizing the control information contained in the XCT 
file. Detailed information on the use and features of CHAIN and EXECUTE 
is provided in the CHAIN XVM/EXECUTE XVM Utility Manual. 

The above operations are outlined in Table 5-6 Source to Object Code 
File Extension/BOSS operation. 

5.5.1 Specifying Data Modes^ 

Operations v/hich involve the interchange of data reguire that the form 
of the data being handled (i.e., its data mode) be indicated in the 
initiating command string. 

Data modes in BOSS are specified either by the filename extension of 
the file being transferred or by an equivalent PIP data mode option 
switch. The Data Mode indicators recognized by PIP are defined below. 
The Data Modes with their respective filename extensions and option 
switches are given in Table 5-7. 


^Refer to the XVM/DOS Users Manual for detailed descriptions of data 
modes . 
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The available PIP data mode switches and their uses are: 

iA} lOPS A SCII Switch - Files containing data in lOPS ASCII 

form require the use of the PIP (A) data mode switch. ASCII 
files are identified by the extensions: 

1) SRC. or 

2) a 3-digit numeric extension (e.g., 004). 

XlJ lOPS Binary Switch - Files containing data in lOPS Binary 

form must be handled using the (B) switch. The filename ex- 
tension BIN is used to identify binary files. 

c. (I) Image Alphanumeric Switch - The (I) switch is required 
during transfer of Image Alphanumeric Files and, as the 
name Image implies, maintains the File data in its exact 
form as read from the source file. The (I) switch must 
specifically be used when copies of paper tapes in either HRM 
or RIM hardware reader modes (MACRO .ABS or .FULL paper 
tape) are required. 

d. (H) Image Binary Switch - Binary files (extension BIN) 
to be maintained in their exact form must be transferred 
using the (H) data mode switch. 

6* (D) Dump Mode Switch - Files containing data in an absolute 

binary form (extension ABS) must be handled using the (D) 
mode switch. 

The specific combinations of data mode switches and optional function 
switches which are permitted in each of the PIP primary operations 
are given in Appendix A. 


Table 5-7 


Data Modes and Data Mode Indicators 



DATA MODES 

lOPS 

ASCII 

lOPS 

BINARY 

DUMP 

IMAGE ALPHA- 
NUMERIC 

IMAGE 

BINARY 

FILENAME 

EXTENSIONS 

SRC 

/ 





BIN 


/ 




ABS 



/ 



Numeric 

/ 





OPTION 

SWITCHES 

(A) 

/ 





(B) 


/ 




(D) 



/ 



(I) 




/ 


(H) 





/ 
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5.6 LINE EDITOR 

BOSS is equipped with a line editor to edit on-line files. The line 
editor is called by the $MAC11, $FIL, $FOR, and $ASM commands. The 
line editor operates on alphameric lines. Three functions are provided 

1. Insertion, 

2. Deletion, and 

3. Substitution. 


New lines can be inserted following a specified line. One or more 
contiguous lines can be deleted; and one or more contiguous lines can 
be substituted for one or more lines (see Table 5-8 Line Editor) . In 
a substitution procedure the number of lines deleted need not be equal 
to the number of lines inserted. 

All line editor commands have a (minus sign) in column one. Source 

lines to be inserted appear on the card as they will be inserted in 
the main storage file (no control character necessary). 


Table 5-8 


Line Editor 


Editor Command Cards 

Command 

Function 

Edit Cards 

1 — i 
Ll 
1 

Insert - following numbered 
line L, , insert source line 
card (sf . 

command card, followed by 
source line card(s) 


Delete - numbered line L^, 
or L^ through 

Command card only 

^l'^2 

Substitute - delete L, or 
L^ through L^, substituting 
source line card(s) . Re- 
order remaining line num- 
bers in file. 

coiniusrid. c3.jTdf folXowGd 
source line card(s) 

Where: 1. L = decimal line number of edited file. 

^1-^2 

2. The Line Editor is called by the $MAC11, $FIL, 
$FOR, and $ASM commands. All Line Editor com- 
mand cards must have a in column one. 
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5.6.1 Insert 


Insertion is specified by the command 


-1 


followed by the source lines to be inserted, one per card. Line one 
(Ll) is a decimal line niimber in the original source file after which 
the new source lines are inserted. The file is scanned through Ll. 
Insertion begins after Ll for as many lines as there are source line 
cards. For example, if FILEA has five source lines; 

LINEl 

LINE2 

LINES 

LINE4 

LINES 

And the following line edit command is issued: 

-3 

LINE A 
LINE B 

then FILEA will look like: 

LINEl 
LINE 2 
LINE3 
LINEA 
LINEB 
LINE4 
LINES 


5.6.2 Delete 


Deletion is specified by the command 


- 1,-2 


where Ll and L2 are decimal line numbers (Ll£L2) in the original source 
file. All lines from line Ll to line L2 inclusive are deleted. 


For example, FILEA has 7 source lines; 

LINEl 

LINE2 

LINES 

LINEA 

LINEB 

LINE4 

LINES 
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and the following line edit commands are issued: 

- 1,-2 

-4,-6 

Then FILEA will look like 

LINES 

LINEA 

LINEB 


5.6.3 Substitute 

Substitutions are specified with a deletion command followed by 
source cards. The range of lines specified in the deletion commands 
are deleted first; then the source lines following the deletion 
command are inserted in their place. For example, assume FILE A has 
the following three lines: 

LINEl 

LINES 

LINE5 


and the following line-edit command is issued: 


- 1,2 

LINEA 

LINEB 

LINEC 


The final edited file will look like the following: 


LINEA 

LINEB 

LINEC 

LINES 


5.6.4 Editing Operation 

The Line Editor uses two input DAT slots (the input file to be edited 
and the Card Reader) and one output DAT slot (the output file) . The 
input and the output files may have the same name or different names, 
depending on the arguments used in the $MAC11, $FIL, $FOR, or $ASM. If the 
names are the same, the original file is lost, and only the edited 
file is kept. If the file names are different, then both the original 
file and the edited file are kept. The input file is read only once. 
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This requires that the line edit commands be ordered so that the line 
numbers are in ascending sequence. If two edit commands have line 
numbers out of sequence, an error message is printed. The input and 
output files are then closed, and the edit is stopped. In this way 
all the edits are made current up to but not including the one with 
the out-of-sequence line number. 

5.7 BOSS PREPROCESSOR (B.PRE) 

The preprocessor B.PRE is a BOSS XVM utility program. Its primary 
function is to preprocess MACRO MACll, and FORTRAN IV (F4) Source 
Files for BOSS. It can be used generally for any file. Thi^ program 
is called by BOSS anytimie an Edit (— ) control card appears. It will 
then do the following: 

1. If no data cards (i.e., cards without a sign in column 1) 

follow the control card, B.PRE exits. 

2. If data cards follow the Edit control card, B.PRE reads each 
data card and an associated ASCII file with their images. 

The file will be read from DAT -2. 

An example of the Edit substitute preprocess for a FORTRAN compilation 
is shown below: 


$JOB COPY ;30f; CMS 
$C DK ^DT^ 

$C DK ^DTl 
$END 

$JOB TSTl;3j?;CMS 
$FOR;B AE^10f^ 
-15,15 

WRITE (6,20f0f) 
-24,24 

IpfpT WRITE (6,20fl) 
-28,28 

lj?2 WRITE (6,2J?2) 
-32,32 

10^4 WRITE (6,20f3) 
-36,36 

10T6 WRITE (6,2j34) 
-40,40f 

110f WRITE (6,20f5) 
-45,45 
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When the line editor is used, the following rules should be followed: 

1. A disk must be used for input/output, or the following error 
message will be printed: 

NON-DISK I/O DEVICE 

and an exit to the next control card will occur. 

2. The same device/unit should be assigned to device-1 and 
device-2, (see Chapter 6, $MAC11, $FOR, and $ASM commands); 
if not the following message will be output and an exit to 
the next control card will occur. 

DIFFERENT DEVICES ASSIGNED TO .DAT-14 & -15 

3. The same UFDT must be used for UIC-1 and UIC-2, otherwise 
the following error message will be printed, and an exit 
to the next control card occurs: 

DIFFERENT UIC ASSIGNED TO .DAT-14 & -15. 

4. The user should use care to ensure that no line-edit com- 
mands are to be performed past the last line of the file, 
or errors will occur. 


5 . 8 CONTINUATION CARD 


The continuation card permits the user to continue command arguments 
via additional control cards. For Expanded Substitution this card 
provides for additional Field Sets. For Direct Substitution it pro- 
vides for additional fields. The format for the continuation Card 
follows . 


$ *ccc [ additional arguments ] 

where: $* = Continuation card. 

ccc = Comment field (documentation only) . 

Additional arguments beginning in column 6. 

Continuation Cards are signaled by trailing punctuation in the 
expanded substitution and direct substitution. A semicolon followed 
by a carriage return or ALTMODE, neglecting spaces, means that there 
is a continuation card for the card being processed. If the card 
following this card is not a continuation card ($*) , then an error 
occurred, and BOSS prints 

ILLEGAL COMMAND CARD SEQUENCE 

For direct substitution the appearance of the ( ; ) does not terminate 
the field being processed. 


5-24 



Language Syntax 


5.9 END OF DECK CARD (FOR SPOOLED UC15 SYSTEMS ONLY) 

The end of deck card enables the user to indicate end of job deck to 
the spooler. This card should be present at the end of a job deck as 
indicated below: 



end of deck card ( ©© card) 


denotes an ALT. MODE 


If the end of deck card is not present in a spooled UC15 system, the 
system will hang, if at least 5 cards are not present after the $END 
card. This is because card images are blocked, six cards to a block. 
These blocks are not written out onto the disk (spooled) unless the 
block is full or the end of deck card is read. 

The end of deck card has no effect if spooling is not enabled since 
the card reader handler for CRll throws it away when read; this card 
is not shown in job deck examples other than the one above. 
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CHAPTER 6 
CONTROL COMMANDS 


6.1 INTRODUCTION 

Once the general card format is understood in terms of Expanded Sub- 
stitution, Direct Substitution, and Field Continuation, the programmer 
can combine that knowledge with the Batch Command Language (BCL) syntax - 
The BCL commands are presented in a self-contained reference format to 
provide the user with the optimum information per command. For ease 
of reference, each command is in alphabetical order and not in a pro- 
cedural sequence. 

BCL provides the user with several levels of program and job control. 
Control functions are as follows: 

Job Control, 

System Program Load Control, 

User Program Load Control, 

File Control, 

Add-File Control, 

Continuation Control, 

Message Control, 

Line Editing Control, 

File Interchange Control (PIP) , 

Emulation. 

The individual BOSS commands required to implement these functions are 
given in Table 6-1 "Command Functions". 

This section provides the user with the following information for each 
BOSS command as follows: 

Function, 

Format, 

Argument, 

Technical Note, 

Example . 
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The command FUNCTION states the general command definition. A FORMAT 
is given which defines each argument in the command string. The 
command string indicates the maximum number of elements supported by 
the system. When any of these string elements is not required for a 
given implementation, its field delimiter ( ; ) must remain in the string 
in the order in which it normally appears (refer to Chapter 6) . Within 
the command string, each element is defined in detail under ARGUMENT (S). 
When the ARGUMENT is given in capitals, it must be implemented as 
shown: when in lower-case, the field content is supplied by the user. 

The user, when supplying arguments, should conform to the command 
requirements as specified in the argument definition and its associated 
TECHNICAL NOTE. EXAMPLE (S) are provided where variations in command 
string usage might be confusing. 

All command string arguments are optional to the user, excluding 
message and literal-value elements. In addition to optional elements 
within the command, the user is provided with certain control param- 
eters by "default". These default assignments are automatically 
assigned by the System. Some default values must be supplied by the 
user at System Generation time. BOSS supplied system defaults are 
noted in the ARGUMENT definition. 
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6 . 2 $ADD 

FUNCTION: The $ADD card permits a BCL card file, created by $CRT, to 

be added to the input stream at a designated point. 

FORMAT: $ADD i_i file-name 

ARGUMENTS: file-name = (Default - TMP ADD) The name assigned to the 
ADD file via $CRT. 


TECHNICAL NOTES: 

1. The $ADD command permits the BOSS user to specify a file of 
BOSS language commands to be inserted in the card input stream 
at a required point. All line images of the file specified by 
"file-name" are assumed to be BCL commands. 

2. No data cards may appear in the ADD file. 

3. $CRT, $ADD, and $JOB are illegal records in an ADD file. 

4. ADD files are assumed to be on the system device, and under 
the current UIC. 

5. All the lines in the ADD file will be executed before 
switching the input stream back to the card reader. 

6. If the file name specified on the $ADD card does not corre- 
spond to a file, the following error message will be output: 

'NON-EXISTENT ADD FILE' 
and the next control card will be executed. 

7. If, after an ADD file is opened, that ADD file is modified, 
the following error message will be output; 

DIFFERENT ADD FILE 

and the next control card will be executed. 

8. Restriction-two $ADD cards in sequence will result in an 
lOPSll error. It is always necessary to put any legal BOSS 
card other than $ADD, $JOB, or $SEND between two successive 
$ADD cards. 
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$ASG 


6.3 $ASG 


FUNCTION: The $ASG card permits the temporary reassignment of the 

Monitor's Device Assignment Table (DAT). In addition, 
the corresponding slots of the User File Directory Table 
(UFDT) can be reassigned to UIC's other than current 
assignments. The DAT and UFDT default assignments are 
made at SGEN time. 


FORMAT: $ASGi_jdat- s lot : device (uic) 


ARGUMENTS: dat-slot = This field contains the DAT slot reassignment. 

The assignment range is from -15 to +77 (octal) . 
Slots reserved for exclusive System use are: 

-2, -3, -7, +5, and +6. 

device = (Default - System Device) This four character 
field denotes the device type, Handler version, 
and unit number. The default for the Handler 
version = A and the unit number = ^ for MT or 
RK or DP or DT. Table 6-2 gives device types. 

uic = (Default - Current UIC) This three character 

field denotes the User Identification Code 
(UIC) to associate with the corresponding DAT 
slot . 


TECHNICAL NOTES: 

1. The Device Assignment Table (DAT) slot structure is the same 
as in XVM DOS, except that in BOSS mode DAT slots +5 and +6 
are permanently assigned to the card reader and line printer 
respectively. The user cannot modify them. Attempted use of 
these slots will result in the error condition: 


PERMANENT DAT SLOT 


2. A $ASG card preceding some System program load commands is 
meaningless since the BOSS procedure File contains standard 
DAT assignments. DAT slot assignments are specified via the 
system program calling commands (e.g., $FOR, $ASM, $DMP, $LIB, 
$MAC11, and $LCM. ) 
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3. Since the number of negative slots does not change (-15 is 
the lowest negative slot) , the user need only be concerned 
with the number of positive slots available. $DOS SCOM or a 
$DOS REQUEST USER command will output sufficient system 
information to let the user determine the number of positive 
DAT slots available, and the system assignments. 


Device Type 

Table 6-2 

Codes for $ASG Command 

DK 

DECdisk 

DP 

Disk Pack 

RK 

Disk Cartridge 

DT 

DEC tape 

TT 

Teleprinter 

PP 

Paper Tape Punch 

PR 

Paper Tape Reader 

LP 

Line Printer 

CD 

Card Reader 

MT 

Magtape 

VP 

VP15 CRT Display 

XY 

XYli/XY311 Plotter 

LV 

LVll Raster Scan Plotter (optional) 

DL 

DLll 10/15 Communications Link (optional) 

SY 

System Disk 
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6 . 4 $ASM 
FUNCTION: 

FORMAT: 


ARGUMENTS : 

Option 

A 

B 

C 

E 

F 

G 

H 

I 

L 

N 

0 

P 

s 

T 


$ASM 


The $ASM card calls the PDP-15 MACRO Assembler and the 
Line Editor. 


$ASM; options ujfi le-name-1 : device- 1 (uic-l) 
; file-name-2 : device-2 (uic-2) 
; file-name-3 :device-3 (uic-3) 
; file-name-4 : device-4 (uic-4) 
; :device-5 (uic-5) 
; :device-6 (uic-6) 


Line Edit Card/s, or 
Source Card/s or 
next BCL command 


options = (Default - B L) A six character option field. 

The options with their associated actions are 
given below; 


Action 

= Print symbols at end of PASS 2 in alphanumeric sequence. 

= Generate a binary file. 

= Program areas that fall between unsatisfied conditionals 
are not printed. It is not necessary to include the L 
option if this option is used. 

= This option enables the user to have any errors occurring 
during assembly printed on the Console Teleprinter in 
addition to device-5. The L or N switch should be used 
with the E option. 

= Process the MACRO definition file. 

Print only the source line of a macro expansion. It is 
not necessary to type the L option. 

Print user symbols after PASS 2. It is used in 
conjunction with A, V or S options. 

Ignore .EJECT'S. The pseudo-op is treated as a 
comment. 

Generate a listing file on the requested output device. 
Number each source line (decimal) . If this option is 
used, it is not necessary to type the L option. If L 
and X are typed MACRO assumes that the N option was 
typed also. 

Causes the assembler to omit the source extension and 
the linking loader code 33 from the binary file. 

Before assembly begins, read assembly parameters from 
device-2. Only direct assignments may be used. 

Same as selecting both A and V options. 

Generate a table, during Pass-1, with the page number 
and the text of all assembled .TITLE statements in the 
program. 
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Option Action 

= Print symbols at end of PASS 2 in value sequence. 

= Load PASS 3 to perform the cross-referencing operation. 
Then continue assembling. 

Z = Read MACRO definition during file PASS 1 and 2. 

file-name-1 = Source File (Edit Output/New file-name) /or Macro 
input file-name 

device-1 (uic-1) = Standard format. 

file-name-2 = Parameter File 

device-2 (uic-2) = Standard format. 

file-name-3 = MACRO Definition File 

device-3 (uic-3) = Standard format. 

file-name-4 = Edit Input (Old file-name) 

device-4 (uic-4) = Standard format. 

device- 5 = Print device 

device-5 (uic-5) = Standard format. 

device-6 = Binary output device (default is the system 
device) 

device-6 (uic-6) = Standard format. 

TECHNICAL NOTES: 

1. The $ASM command provides the user with the symbolic pro- 
gramming capabilities of the MACRO XVM assembler which includes 
macro instruction generator. 

2. When the user program has been successfully assembled, the 
output is a relocatable "object module" (BIN extension) . This 
module can be further processed by using the $MAP or $OVL and 
$LNK commands. These commands will produce a "load module" 
(absolute file) with a file extension of XCT. The XCT file is 
actually two files, one with an XCT extension and the other 
with an XCU extension. The user can assemble for an absolute 
file (.ABS files cannot be chained). For further information 
see the CHAIN XVM/EXECUTE XVM Utility Manual. The load module 
must be executed using the $XCT command to run the user's ob- 
ject program. 

3. If the line editor is to be used, the following rules should 
be followed: 

a. DECdisk, disk pack, or disk cartridge must be used for 
input/output, or the following error message will be 
printed : 

'NON-DISK I/O DEVICE' 


and an exit to the next control card will occur. 

b. The same device/unit should be assigned to device-1 and 
device-4. If not, the following message will be printed 
and an exit to the next control card will occur. 


'DIFFERENT DEVICES ASSIGNED TO .DAT-14 & -15' 
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c. The same .UFDT must be used for UIC-1 and UIC-4, otherwise 
the following error message will be printed, and an exit 
to the next control card will occur: 


'DIFFERENT UIC ASSIGNED TO .DAT-14 & -15' 


The $ASM command can be used to: 

a. Assemble a file already existing. The $ASM card must 
specify file-name-1, and the next control card should 
follow the $ASM command. 

b. Create a new file and assemble it. The $ASM card must 
specify file-name-1, and the "source" deck should follow 
this command. 

c. Assemble without creating a file. No file-name should be 
specified, and the "source" deck should follov/ the $ASM 
command. 

d. Edit an already existing file and assemble it. The file- 
name-1 must be specified, and line-edit commands should 
follow the $ASM command. 

e. Edit an already existing file, create a new "edited" file 
and assemble the newly created file. The original source 
file-name is specified in file-name-4. The new source 
file-name is specified in file-name-1, and the $ASM 
command should be followed by the line-edit commands. 

Depending on which function (see options above) the $ASM 

command specifies, the command can be followed by: 

A MACRO source deck, 

Line-Edit Commands, 

The next Control Card. 


For additional information refer to the MACRO XVM Assembler 
Language Manual . 



Control Commands 


$ENK 


6 . 5 $BNK 


FUNCTION: The $BNK card selects BANK Mode system operation (8K) . 


FORMAT: $BNK 


TECHNICAL NOTES: 

1. The default addressing mode is established at System Generation 
time by the System Manager. 

2. In Bank Mode, Index Register usage is not permitted. _ User 
programs (including device handlers) are loaded within 8K 
memory banks using 13 bit address relocation. System library 
routines are loaded from the library contained in the BNK 
(uic) system directory. A $BNK card sets the system to oper- 
ate in BANK mode. Conversely, a $PAG card sets the system to 
operate in PAGE Mode. 
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$BUF 


6.6 $BUF 


FUNCTION: The $BUF card temporarily changes the default value for 

the number of buffers available. 


FORMAT: $BUFL_inumber 


ARGUMENTS: number = number (decimal radix) of buffers desired. 


TECHNICAL NOTES: 

1. This command temporarily changes the default value for the 

number of buffers available (in the Monitor's buffer pool) 
for disk I/O and for the .GVBUF and .GTBUF requests. The 
default value is restored by the System whenever the Non- 
Resident Monitor returns (after the succeeding system program 
or user program load) . This value is set during system 
generation along with the actual size of the buffers to be 
allocated (the default values for systems as initially distri- 
buted are: Number of Buffers = 3, Buffer Size = 500g. 

BOSS automatically adds one buffer to facilitate the Run 
Tim.e File) . 

2. The user should exercise care when issuing this command by 
considering the trade-off of available core versus the con- 
venience of a large number of buffers. The handlers for the 
three disk types always obtain the buffers required for 
their operation from the same common buffer pool. One of 
these buffers is required for each opened file. Terminal 
errors can result when an insufficient number of buffers 

is available. Alternatively, program loading errors can 
occur when the number of buffers allocated results in an 
insufficient amount of core for program loading. The user 
need not be concerned about buffer availability for system 
programs since each system program has its own default para- 
meter for the maximum number of buffers required (e.g., 

MACRO has 4, EDITOR has 4.). If, however, he issues a $BUF 
command, the number on that card will take precedence over the 
default for a system program. 
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6 . 7 $CHN 


FUNCTION; The $CHN card is used to specify 7-track or 9-track 
Magtape operation. 


FORMAT: 




ARGUMENTS; 7 = 7-track Magtape 
9 = 9-track Magtape 


TECHNICAL NOTES: 


1. The track count is set at System Generation time and can be 
modified by $CHN. 

2. If 9-track is specified, density is assumed to be 800 BPI. 
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m? 


6 . 8 $CMP 


FUNCTION: The $CMP card provides the user with a utility program 

which compares two source programs via the SRCCOM program. 


FORMAT: 


$CMP; < 


A 

C 

M 

Rn| 


^i_jnewfile-name : device-1 (uic-1) 
;oldfile-name:device-2 (uic-2) 


ARGUMENTS: Options - SRCCOM switch options are as follows: 

A = Switch A is used to specify an abbreviated output 
format (Affected lines are not printed) . 

C = Used to ignore ASCII characters outside of the range 
240-337 except for carriage return and horizontal tab 
characters . 

M = Used in MACRO XVM comparisons to ignore comments and 
to perform space tab conversions. 

Rn = Used to determine the number of consecutive lines 
that SRCCOM must rematch in order to detect an 
insertion or deletion (i.e., rematch factor). This 
switch is written as Rn, where: n is any digit from 
1 to 9 . The default value of n is 6. 

newfile-name = This ten character field specifies the file-name of 
the new symbolic program to be compared to the 
symbolic program in the file specified by old file- 
name . 

device-1 (uic-1 - The device which newfile is on 
Standard format. 

oldfile-name = This ten character field specifies the file-name of 
the old symbolic program. 

device-2 (uic-2) = The device which oldfile is on 
Standard format. 


TECHNICAL NOTES: 

1. The $CMP command calls a utility program SRCCOM which compares 
two symbolic programs (SRC - written in lOPS ASCII) and in- 
dicates the differences between the compared programs. Out- 
put statements are made to the line printer. 

2. When comparing programs which have had extensive modifications 
made in relatively small areas, the value of "n" in the R 
switch should be 6 or higher. Smaller values of "n" may 
result in erroneous SRCCOM reports. 

3. For further information refer to the SRCCOM XVM Utility 
Manual . 


6-13 




Control Commands 


EXAMPLES : 

1. To compare MACRO program NEWFIL to MACRO program ORGFIL 
with M switch on: 


$CMP ; M|_|NEWFILi_jSRC : DK (EEM) ; ORGFILi_iSRC : DK (EEM) 

2. To compare NEWFIL to ORGFIL with all switches on: 

$CMP ; A , C , M , R5t_jNEWFILu_jSRC ; ORGFILu-iSRC 

3. To compare two programs with no switches on: 

$ CMP i_iNEWF I L ; ORGF I L 
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6.9 $CRT 


FUNCTION: The $CRT card is used to create $ADD files containing 

BOSS Control Language (BCL) images. 


FORMAT: $CRT file-name 


ARGUMENT: file-name = The name to be assigned to the ADD file. 

(Default - TMP ADD) 


TECHNICAL NOTES: 

1. The $CRT command is used to create ADD files. ADD files are 
files containing BCL images. All cards following the $CRT 
card will be written on the specified file until a "$$" card 
(dollar sign in columns one and two) is reached. 

2. Illegal ADD file cards are: $CRT, SADD, and $JOB. Also 

data cards must not be included in an ADD file. In a case 
of error, the following message is output: 

'ILLEGAL COMMAND FOR ADD FILE’ 
and the job is terminated. 

3. Restriction - two SCRT cards in sequence will result in an 
lOPSll error. It is always necessary to put any legal BOSS 
card other than $CRT, $JOB or $SEND between two successive 
$CRT cards. 


EXAMPLE: $CRT^TMPFL2 

BCL cards 


$$ 
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^ $DIR 

6.10 $DIR 


FUNCTION: 


FORMAT: 


ARGUMENTS : 


EXAMPLES : 


The $DIR card causes the directory of the device specified 
in the argument list to be output to the line printer. 


$DIRi_idevice (uic) 


device = (Default - System Device) This four character 
field specifies a directoried file device. 

Device type, handler version, and unit number 
can be specified. The default for the handler = 
A, and the unit number = 0 for DK, DP, RK, or DT. 

uic = (Default - Current UIC) This three character 

field denotes the User Identification Code (UIC) 
to associate with the corresponding DAT slot. 

It specifies the UIC in case the device is DK 
(DECdisk) RK (Disk Cartridge) or DP (Disk Pack) . 
It is ignored in all other cases. 


Command - 

$DIRl-jDK(DOE) 

$DIRl-jDT3 

Job String - 

$JOBt_jTEST 

$DIRi_jDT1 

$END 

End-Of-File Card 
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6.11 $DLG 


FUNCTION: The $DLG card causes the LOG-OUT of the current UIC. 


FORMAT: $DLG 


TECHNICAL NOTES: 

1. The $DLG command causes the LOG-OUT of the current UIC, and 
the reinstating of the default UIC "SCR". No arguments are 
needed for the $DLG command. 

2. In addition, the $DLG command causes all default device 
assignments to be reset. The $ASG command should be used to 
make new device assignments. 
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$Df1P 

6.12 $DMP 
FUNCTION : 

FORMAT : 
ARGUMENTS : 


The $DMP card provides the user with the ability to out- 
put specified core locations from the CTRL Q area to any 
available listing device, or any physical block of a 
block oriented device. 


$DMP. .command 


command: (Default - ALL) This field specifies any legal 

DUMP command as specified in XVM/DOS. The 
DUMP commands are: 

All = The ALL command will list the contents of the 
CTRL Q area from location 5 to the highest 
memory location of device-1 (DAT -14) upon 
device-2 (DAT -12) . Highest memory location 
is defined as: 

1. fQ area on disk devices: The highest mem- 

ory location dumped to the +Q area as 
determined by appropriate .SCOM locations 
in the image on the IQ area . 

2. iQ area on DECtape: The current memory 

size, as determined by appropriate .SCOM 
locations in core. To dump other DECtape 
IQ area sizes use the ALL (nn) option 
described in note 4. 

a - b = List the CTRL Q area between absolute address 
a and b (in octal) of device-1 upon device-2. 

Where "a" is greater than or equal to 5 and 
"b" is less than or equal to: 

1. iQ area on disk: The highest memory 

location (defined above) 

2. iQ area on DECtape: 377777. (131071,.). 

o 10 

nnn# = List the contents of block nnn (octal of 
device-1 upon device-2. For DECtape, the 
command nnn# may be followed by a minus (-) ; 
block nnn will be read in the reverse direc- 
tion . 
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TECHNICAL NOTES: 

1. The $DMP command provides the user with the ability to output, 
on any available listing device, specified core locations 
which have been stored on a bulk storage device using the 
$QDP (CTRL Q) command. The QDUMP argument of the $JOB card is 
an unconditional (ALL) dump. $QDP is initiated via a terminal 
error and is conditional on the command placement within the 
job deck. 

2. If device-2 (listing output) is a directoried device, the 
listings output will go to a file named MEMORY DMP. 

3. If device-1 is assigned to any device other than DECtape, Disk 
Pack or DECdisk, BOSS will exit the job string to the next 
control card. In the special case when the system device is 
Disk Pack, and device-1 is assigned to a DECdisk, an exit to 
the next control card will also occur. 

4. The "ALL (nn) " command will specify that the DECtape +Q 

area size (nn=24, 32, 40, 48, .... 120, 128) is different 

than that of the current system memory size. This option 
is valid only if device-1 (.DAT-14) is assigned to DECtape. 

5. The first block number and size of the CTRL Q area can be 
determined by listing SYSBLK with BOSPIP: 

$L^LP^DK^(L) 
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6.13 $DOS 


FUNCTION: The $DOS card is a general procedure file for implementing 

XVM/DOS command strings. 


FORMAT: $DOS. .dos-command-string 


ARGUMENT: dos-command-string = (default - Alt Mode) This field is 

used to specify any legal XVM/DOS 
command string. 


TECHNICAL NOTE: 

The $DOS command is a "direct substitution" procedure file which 
can be of general use for giving XVM/DOS command strings. 


EXAMPLE : $ JOB^TEST 

$DOS|_^REQUEST 

$DOS^SCOM 

$END 

(Dos End-Of-File Card) 

Where : 

1 . REQUEST - The REQUEST command causes a typeout of the I/O 
Device Handlers currently associated with the slots of the 
Monitor's Device Assignment Table (DAT). 

2. INSTRUCT - The INSTRUCT command causes a listing of either 
the keyboard commands (INSTRUCT) or system errors 
(INSTRUCT ERRORS) . 

3 . SCOM - The SCOM command causes the typeout of XVM/DOS 

system information. The information includes: (a) available 

I/O device handlers, (b) system default param.eters, (c) 
important core addresses, and (d) the Priority Interrupt 
System's I/O Device Skip Chain order. 

NOTE: For more information on DOS commands refer to the 

XVM/DOS User ' s Manual . 
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SEND 


6.14 $END 


FUNCTION: The $END card marks the end of a Job. 


FORMAT: $END 


TECHNICAL NOTES: 

1. When a Job is closed with a $END command, a message is output 
on the line printer. The message specifies in minutes the 
time taken for the Job to complete, the time of day of job 
initiation and termination, and the date. 

2. After a $END card, BOSS will look for a $JOB card. Therefore 
a $END card should be followed only by a $JOB card, or an 
End-Of-File card. 
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6.15 $FIL 


FUNCTION; The $FIL card is used to create a file or to edit an 
existing file. 


FORMAT; $FILi_jnew-f ile ;device (uic-1) ;old-f ile ;device-2 (uic-2) 


ARGUMENTS ; 

new-file = (Default - FILTMP SRC) This ten character field 
specifies the source file-name and extension of 
the file to be created. 

device-1 = (Default - System Device) This four character 
field contains the device on which to create 
or edit the file. This must be a directoried 
device . 

uic-1 = (Default - Current UIC) This three character 
field contains the name of the UFD to use when 
the device assignment is disk. 

old-file = (Default - FILTMP SRC) This ten character field 
specifies the original file-name to be edited 
if the desired edited file-name "new-file" is 
different. 

device-2 = (Default - System Device) This four character 
field contains the device on which the original 
file is stored. This must be a directoried 
device, the same as device- 1. 

uic-2 = (Default - System Device) This three character 
field contains the name of the UFD to use when 
the device assignment is disk. UIC-2 should 
be the same as UIC-1. 


TECHNICAL NOTES; 

1. If the line editor is to be used, the following rules should 
be followed; 

a. A disk must be used for input/output, or the following 
error message will be printed; 


'NON-DISK I/O DEVICE' 


and an exit to the next control card will occur. 
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b. The same device/unit should be assigned to device-1 

and device-2; if not, the following message will be output 
and an exit to the next control card will occur: 


•different devices assigned to .DAT-14 & -15' 


c. The same uic must be used for UIC-1 and UIC-2; otherwise 
the following error message will be printed, and an exit 
to the next control card will occur: 


•different uic assigned to .DAT-14 & -15.' 


2. The $FIL command is used to create a file, or to edit an 
existing file on a directoried device. To create a new file, 
the file-name should be specified in "new-file" and the source 
deck should follow the $FIL command. 

3. To edit an existing file, the file-name should be specified 
in "new-file" and the line-edit commands should follow the 
$FIL card. 

4. To edit an existing file and create a new edited file while 
leaving the original untouched, the original source file-name 
should be specified in "old-file". The new source file-name 
should be specified in "new-file". The line-edit commands 
should follow the $FIL command. 


EXAMPLES: Create - Edit - 

$FILi-jNEWFILfcjSRC $FILi_iOLDFILuSRC 

Source Deck - 5,10 


BCL card or $ 

BCL card of $ 
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6.16 $FOR 


FUNCTION: 


The $FOR card calls FORTRAN IV (F4M or FPF4M) Compiler 
and the Line Editor. 


FORMAT; $FOR; optionsi_jf ile-name-1 :device-l (uic-1) 

; file-name-2 :device-2 (uic-2) 
; :device-3 (uic-3) 

Line Edit Card/s, or 
Source Card/s, or 
BCL card 


ARGUMENTS: options - (Default - B, L) A six character option field 

The FORTRAN options follow: 

B = Binary output 
L = Source listing 
0 = Object listing 
S = Symbol map 

file-name-1 = (Default - FILTMP) This ten character field 
specifies the SOURCE file-name. The source 
extension is assumed to be SRC. 
device-1 (uic-1) - Standard format. 


file— name— 2 = (Default — file— name— 1 or FILTMP) A ten 

character field used to specify the name of 
the original source file to be edited. ^ This 
name is required to edit an existing file, 
create a new "edited' file and compile the 
newly created file. 

device-2 (uic-2) = Standard format. 

device-3 = (Default - Line Printer) This field is used to 
specify the desired output listing device 
(DAT = -12) . 

device-4 = (Default - System Disk) This field is used to 
specify the desired binary output device. 

uic-4 = (Default - Current UIC) This field is used if 
( 3 ^ 0 \rice — 4 specifies disk as the output device. 


TECHNICAL NOTES: 

1. If the line editor is to be used, the following rules should 
be followed: 

a. A disk must be used for inpu^output, or the following 
error message will be printed: 
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'NON-DISK I/O DEVICE' 


and an exit to the next control card will occur. 

b. The same device/unit should be assigned to device-1 and 
device-2; if not, the following message will be output 
and an exit to the next control card will occur: 


'DIFFERENT DEVICES ASSIGNED TO .DAT-14 & -15' 


c. The same uic must be used for UIC-1 and UIC-2, otherwise 
the following error message will be printed, and an exit 
to the next control card will occur: 


'DIFFERENT UIC ASSIGNED TO .DAT-14 & -15' 


2. The $FOR command can be used to; 

a. Compile a file already existing. The $FOR card must 
specify file-name-1, and the next control card should 
follow the $FOR command. 

b. Create a new file and compile it. The $FOR card must 
specify file-name-1, and the "source" deck should follow 
this command. 

c. Compile without creating a file. No file-name should be 
specified, and the "source" deck should follow the $FOR 
command . 

d. Edit an already existing file and compile it. The file- 
name-1 must be specified, and the line-edit commands 
should follow the $FOR command. 

e. Edit an already existing file, create a new "edited" file 
and compile the newly created file. The original source 
file-name is specified in file-name-2. The new source 
file~name is specified in file-name-1, and the $FOR command 
should be followed by the line-edit commands. 

Depending on which function (a, b, c, d, or e above) the $FOR 
command specifies, the command can be followed by: 

A FORTRAN Source Deck, 

Line-Edit Commands, 

The next Control Card. 

3. A source deck makes up a FORTRAN-IV source program. This 
program is a sequence of symbolic statements translated by 
the FORTRAN compiler into an object program module. The 
basic unit of expression, in a FORTRAN source program, is a 
statement. 

A FORTRAN statement consists of a command portion which 
characterizes its function and may in addition require argu- 
ments. The form in which statements and comments are entered 
is governed by a 72-character line on a Standard FORTRAN 
coding form. The columns on the coding sheet correspond to 
card columns, and one character per column. 
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4. When the user program has been successfully compiled, the 
output is a relocatable "object module" (BIN extension) . This 
module can be further processed by using the $MAP or $OVL and 
$LNK commands. These commands will produce a "load module" 
(absolute file) with a file extension of XCT. The XCT file 

is actually two files, one with an XCT extension and the 
other with an XCU extension. For further information see the 
CHAIN XVM/EXECUTE XVM Utility Manual. The load module 
must be executed using the $XCT command to run the user's 
program. 

5. For further FORTRAN information refer to: 

FORTRAN IV XVM Language Manual, and FORTRAN IV, XVM 
Operating Environment Manual . 


EXAMPLES : 

A. 1. $F0Ri_iFILEi_jSRC:DT3 

Next BCL Command 
2. $FOR;OBi_iFILE 

Next BCL Command 

B. 1. $FORi_jFILE 

Source Deck 
2. $F0R;0 Bi_jFILE:DT 5 
Source Deck 

C. 1. $FOR 

Source Deck 
2. $FOR;OS 

Source Deck 

D. 1. $FORi_jFILE 

Line-Edit Commands 
2. $F0R;0BuJFILE:DT5 

Line-Edit Commands 

E. 1. $FORt-jFILEN:DK(MGC) ;FILEO:DK (MGC) 

Line Edit Commands 

2. $FORi_jFILE:DK(MGD) ; FILEl : DK (MGC) ; : DT0T 
Line Edit Commands 
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6/17 $JOB 


FUNCTION: The $JOB card marks the beginning of a user's job, and 

establishes general control parameters. 


FORMAT : $ JOBi_jid ; time -limit ; uic ; QDUMP ; 


ARGUMENTS: id = Identification field consisting of one to nine 

alphanumeric characters. This field is used to 
identify the job and all messages pertaining to 
it, including operator communication. 

time-limit = (Default "1") - This ten character field specifies 
the maximum running time in minutes for the 
current job. If the time expires, the JOB is 
aborted with the message; 


TIME ESTIMATE EXCEEDED 


If the limit specified is "0" no limit exists, 
and the program can run indeterminantly . 

uic = (Default "SCR") A three letter field for the 
current User Identification Code (UIC) which 
may be supplied by the user for each job. A UIC 
is part of the file protection scheme. 

QDUMP = If an unconditional automatic core dump is 

desired on an lOPS error, this field must contain 
"QDUMP". A listing of the Control Q area is 
output on the Line Printer from the System device. 
The Control Q area size is established at System 
Generation (SGEN) time. 

ON/OFF = (Default = OFF) If the KEEP function is desired, 
"ON" should be specified. This command instructs 
the System to retain or reset device/file- 
directory assignments after completion of the 
current program. 


TECHNICAL NOTES: 

1. All jobs must begin with a $JOB card. 

2. For use in the Accounting File, the ID parameter is limited to 
nine characters. 

3. $JOB will always cause the SCR uic to be cleared. 




6-27 




Control Commands 


3. When command arguments are used, all intervening punctuation 
must be given whether or not the respective argument is 
utilized. 


EXAMPLES : $ JOB 

$JOBi_iTEST-lSRC; ;EEM 
$J0Bi_j;2;IDU 
$JOBi_j; ;EEM 
$JOBu_jID; 10 ;UIC 
$ JOBi_jID ; 10 ; UIC : QDUMP ; ON 
$JOBuID; 10;EHM 


6-28 



Control Commands 


$KEP 


6.18 $KEP 

FUNCTION: The $KEP card instructs the BOSS Monitor to retain 

DAT/UFDT slot assignments as revised via $ASG. 


FORMAT: 


--{off} 


ARGUMENTS : 


ON 

OFF 


$KEPi_jON retains 
$KEPi_iOFF resets 


the device assignments, 
the device assignments. 


TECHNICAL NOTES: 

1. The OFF command permits $ASG device assignments to revert to 
those established by System Generation. 

2. This command should be used primarily with the user's object 
module since BOSS automatically overrides $ASG, and $KEP when 
loading System programs requiring standard device assignments. 
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$LCM 


6.19 $LCM 


FUNCTION: 


FORMAT: 


ARGUMENTS : 


The $LCM card specifies a library file update function. 
It is a supplementary command to the $LIB command. 


$LCMi_jf unction ; program-name- 1 ; program-name- 2 


function - (Default - CLOSE with a Carriage Return) 

This field specifies the UPDATE function to be 
performed. Either the abbreviated form of the 
function or the entire function name can be 
specified. The UPDATE functions are: 

C = CLOSE name-2 This function is the normal 

terminator for any UPDATE operation. When used 
with the U option, it causes all of the re- 
maining programs in the primary input file to 
be copied onto the output file starting at the 
current position of the file. When used with 
the N and L options, the C function permits 
normal output file closing operations and 
initiates the output listing file. If a file 
name is not specified with this command the 
output file is given the name originally 
specified in the last $LIB file-name-1 command. 

D = DELETE name-1, or name-1 through name- 2 This 

command causes the deletion from the specified 
file of a named routine or a range of routines. 
This is specified by name-1 of the first routine 
and name-2 as the last routine of the range. 

This function may be used only when the $LIB 
"U" option has been specified. 

E = END This function causes the output file to be 
positioned at the end of the final routine of 
the original file. All remaining programs in 
the original file, beginning at its current 
position, are copied into the output file. 

F = FREE name-1 This function frees or extracts a 
named file from the library file named in the 
"G" option of the $LIB command. The extracted 
program is transferred to the output device as 
a file of the same name. 

I = INSERT name-1, or name-1 after -name-2. This 
function instructs UPDATE to insert programs 
contained on the secondary input (device- 3) 
into the original file (at any point) as it 
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is copied onto the output file (device-2) . On 
completion of an insert operation, the output 
file is positioned at a point immediately after 
the inserted program. If one name is used in 
the command, the named program is inserted into 
the file at the current position. If two names 
are specified, the name-1 program is inserted 
into the file immediately after the program 
specified by name-2. 

R = REPLACE name-1, or name-1 with name-2 The R 
function causes programs in the original file 
to be replaced by new programs on the secondary 
input device (device-3) . All programs in the 
oJ^iginal file, up to the element or routine to 
be replaced, are copied onto the output device 
(device-2) . The new program (s) is then copied 
onto the output file from a secondary input. 

Upon completion, the output file is positioned 
immediately after the replaced routine. If one 
program name is specified, UPDATE replaces the 
name-1 program with a new program having the 
same name. If two programs are specified, name- 
1 is replaced by name-2. 

program-name-1 = This ten character field specifies the name of 
a program to be acted on. It is used as speci- 
fied by a particular $LCM function and corre- 
sponds to the $LIB command string. 

program-name-2 = (Default - program-name-1) This name is used 
as specified by a particular $LCM function and 
corresponds to the $LIB command string. When 
a CLOSE function is to be perform.ed with a 
file-name, the desired file-name must be in the 
program-name-2 field. 


TECHNICAL NOTES: 

1. The $LCM command specifies a library file update function. 

It is a supplementary command to the $LIB command. The $LCM 
command must follow either a $LIB card or another $LCM card. 

2. Only one update function can be specified on the $LCM card. 
Refer to the following Table 6-3 "Legal Option/Command 
Combinations" . 

3. The END function is a convenient method of positioning the 
file to be modified. This will permit new routines from the 
secondary input to be appended to the file via the INSERT 
function. 

4. Any number of $LCM cards can follow a $LIB card. 

5. For more information, refer to the UPDATE XVM Utility Manual. 
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TABLE 6-3 

LEGAL OPTION/COMMAND COMBINATIONS 



EXAMPLES: $LCMi_jR; AUX10 

$LCMujC; ; .LIBR l 
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$LIB 


6.20 $LIB 


FUNCTION: The $LIB card is used to call the Utility program UPDATE. 

It is used in conjunction with the $LCM card to specify 
the update activity. 


FORMAT: $LIB ; optionsi_jf ile-name-1 : device-1 (uic-1) 

; :device-2 (uic-2) 
; :device-3 (uic-3) 
; :device-4 (uic-4) 


ARGUMENTS: options - (Default - LSU) A six character option field. 

The UPDATE options follow: 

G = Get via FREE This option primes UPDATE to accept 
the FREE manipulative command which allows 
individual programs to be extracted from libraries 
as separate files. 

L = List Element & Size This option lists the 

contents of the new or updated library output to 
device-2 (DAT-15) on the device assigned by device- 
4 (DAT-12) . If no other options are selected, a 
listing of the named library residing on the 
primary input, device-1 (DAT-14) can be obtained. 

N = New Library File This option permits a new 
library file to be created from programs re- 
siding on device-3 (DAT -10) . The. new library 
is output to device-2 (DAT -15) . 

£ = Remove Symbol Table The S option causes UPDATE 
to remove the local symbol table from each 
program placed in the output file (device-2) . 

U = Update via Deletion/Replacement This option 
permits the updating of an existing library 
file by the deletion, insertion and replacement 
of the programs within it (see $LCM command) . 

The file to be updated resides on the device 
assigned to device-1 (DAT -14) ; programs to be 
inserted must be on device- 3 (DAT -10) ; and 
the update file is output to device-2 (DAT -15) . 

file-name-1 = (Default - .LIBR BIN) This ten character field 
specifies the name of the library file to be 
updated. 

device-1 = (default - System Device) This field is used 
to specify the device on which file-name-1 is 
present (DAT -14) . 
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uic-1 = (Default - Current UIC) This field is used to 
specify the UIC when device-1 is disk. 

device-2 = (Default - device-1 or System Device) This field 
is used to specify the library output device 
(DAT -15) . 

uic-2 = (Default - uic-1 or Current UIC) This field is 
used to specify the UIC when device-2 is disk. 

device-3 = (Default - System Device) This field is used to 
specify the secondary input device (DAT -10) . 

uic-3 = (Default - Current UIC) This field is used to 
specify the UIC when device-3 is disk. 

device-4 = (Default - Line Printer) This field is used to 
specify the listing device (DAT -12) . 

uic-4 = (Default - Current UIC) This field specifies the 
UIC when device-4 is disk. 


TECHNICAL NOTES: 

1. Every $LIB command must be followed by at least one $LCM 
command. 

2. The S option causes UPDATE to remove the local symbol table 
from each program placed in the output file. This process 
shortens the length of a file by as much as 40% thus con- 
serving storage space and reducing library search time during 
loading. Non-library programs will occupy less core since there 
will be no symbol table to load. 

3. The $LIB command indicates the UPDATE operation and the name 
of the file to be modified or created. To manipulate the con- 
tents of named file, the user must specify action commands 
via the $LCM command. Legal option/command combinations are 
given in Table 6-3. For more information refer to the UPDATE 
Utility Manual. 
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$LNK 


6.21 $LNK 


FUNCTION: The $LNK card is used to describe a LINK of the overlay 

structure created by CHAIN. 


FORMAT: $LNK string. 


ARGUMENT: string = (Default - ALT MODE) LINK-name = definition 

The overlay structure is described in terms of 
LINK names on the $LNK card followed by the 
definition. Each LINK definition requires one 
card. 


TECHNICAL NOTES: 

1. The $LNK command is used to describe a LINK of the overlay 
structure being created by CHAIN. Each LINK command des- 
cribes one LINK or overlay definition. 

2. Each LINK definition requires a $LNK command, so that normally 
a sequence of $LNK commands would be used. The $LNK commands 
m.ust follow the $OVL comm.and, or another $LNK comm.and. 

3. Only one LINK may be specified per card. The default LINK 
definition is an ALT MODE; therefore, the last $LNK command 
should have no arguments . 

4. When a LINK is to consist of only one external component, the 
name of the file containing the external component may be 
used as a LINK name. When a LINK is to consist of more than 
one external component, the LINK must be named and defined. 

5. Each LINK definition requires one card of command input 
consisting of the LINK'S name followed by an equal sign (=) 
followed by the LINK definition. The last definition card 
should be followed by a $LNK only card. A LINK definition 

is a list of the names of files which contain the relocatable 
binary units that comprise the LINK components. The individual 
file names listed are separated by commas (,); the two types 
of LINK components which may be used (external and internal) 
are separated within the definition by a slash (/) . All 
external LINK component names must be listed before (to the 
left of) the slash separator; all internal LINK components 
must be listed after (to the right of) the slash. External 
LINK components are accepted only from files with names which 
match the external component name (i.e., GLOBAL symbol 
definition) . 
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Example : $LNKi_jABC=SUBl , SUB2/SUB3 , SUB4 


In the above example, SUBl and SUB2 are external components 
of LINK ABC, and SUBS and SUB4 are internal components of 
LINK ABC. 

6. Rules for defining a LINK: 

1) A LINK may not be a component of another LINK. 

2) The names of the components of a LINK may not be used 
as LINK names. ^ 

3) A file name used in the resident code description 
cannot be used in a LINK definition. 

4) A file name preceding a slash may be used only once. 

5) A file name following a slash may be used in other 
LINK definitions (following a slash) . 

7. OVERLAY STRUCTURE DESCRIPTION - An overlay structure is 
described using the names of defined LINKS, or the names of 
files containing LINK components and the operators colon (:) 
and comma (,), under the following set of rules: 

1) A line is an independent statement processed from 
left to right. 

2) A colon is read "is overlayed by".^ 

3) A comma is read "and". 

Example : 

SUB1:SUB2 
SUB2 :SUB3,SUB4 

is interpreted as — SUBl is overlayed by (uses the 
same core as) SUB2 , SUB2 is overlayed by SUB3 and 
SUB4, but SUB3 and SUB4 do not overlay each other. 

4) A colon operator may not be used in a line after a 
comma has been used. This restriction prevents the 
following ambiguity: 

SUB2 : SUB3 , SUB4 : SUBS 

The above line is rejected by CHAIN because it is not 
clear whether SUBS overlays SUBS or SUB4 or both. All 
four of the following examples are acceptable: 

SUB2 : SUBS , SUB4 SUBS uses the same core as SUB4 
SUB4:SUBS but not the same core as SUBS. 

SUB2 : SUBS , SUB4 SUBS uses the same core as SUBS 
SUBS: SUBS but not the same core as SUB4. 


^When a LINK consists of only one component, the component's file name 
may be used as the LINK name in the "overlay structure description" , 
but not in a LINK definition; i.e., it is not necessary to define a 
single component LINK but, if defined, the LINK name cannot be the 
component name. 

^A loading order is not implied; just core mapping. 
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SUB2 : SUBS : SUBS , SUB4 SUBS uses the same core as SUBS 

and SUB4. SUBS and SUB4 are 
loaded individually (if non- 
resident) as called. 

LINK=SUBS , SUB4 SUBS uses the same core as SUBS. 

SUB2 : LINK : SUBS and SUB4. Both SUBS and SUB4 are 

loaded (if non-resident) whenever 
either is called. 

5) A LINK name may appear only once preceding a colon 
and only once following another colon. 

6) If a LINK name is used twice, it must be used fol- 
lowing a colon before being used preceding another 
colon. 

7) Several LINKS overlaying each other may be defined in 
one statement. 

SUBl : SUB2 : SUBS , SUB4 ^ 

NOTE 

This is a short method of defining 
the same overlay structure as in 
the first example, under rule S. 

Rules S and 6, although they may appear restrictive, do not 
limit the user's description of an overlay structure, but 
do prevent multiple description of the position of a LINK 
in an overlay structure. A LINK may be both overlayed and 
overlaying, and it may not be possible or convenient to 
describe both conditions by using the LINK name only once, 
as follows: 

SUBl : SUB2 : SUBS SUB2 is overlaying SUBl and is 

overlaying by SUBS. 

Therefore, when a LINK is both overlaying and overlayed, its 
LINK name may be used twice, but the LINK(s) overlayed by it 
must be described before the LINK(s) by which it is overlayed. 

Example: SUB2 : SUBS , SUB4 SUBS overlays SUB2 

SUBS: SUBS SUBS is overlayed by SUBS 

NOTE 

The description of an overlay structure only 
defines a desired core mapping; i.e., stating 
that SUBl is overlayed by SUB2 means that 
both are to be relocated to the same core and 
cannot co-reside, but does not imply that SUBl 
must be called before SUB2. There is no im- 
posed order in which routines must be called. 


^A loading order is not implied; just core mapping. 
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nor is there restriction of the routines 
callable by any routine. 

8. For further information, refer to the CHAIN XVM/EXECUTE 
XVM Utility Manual. 

Examples : 

$OVLi_jXCTFIL,* PGR; MAIN 
$LNKi_jLINKl=LNKl /DUMMY 
$LNKi_jLINK2=LNK2/DUMMY 
$LNKujLINKl : LINK2 : LINKS 
$LNKi«iLNK4 : LNK5 
$LNK 
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$L0G 


$.22 $LOG 


FUNCTION: The $LOG card specifies a new current User Identification 

Code (UIC) . 


FORMAT: $LOGi_iuic 


ARGUMENT: uic = (Default - SCR) This three character field must 

contain a three letter code for the current UIC. The UIC 
is part of the file protection scheme. 


TECHNICAL NOTES: 

1. The $LOG command specifies a new current UIC. This function 
is also performed by the $JOB command; but the $LOG command 
allows the user to change the current UIC during a job. 

2. This command permits the user to enter his user UIC into the 
system in order to do directoried disk I/O. The Monitor sets 
the slots of the UFDT to the three-character code after LOG. 

All input/output operations to the disk are directed to the 

UFD associated with the UIC last entered by this command, unless 
a program has subsequently done a .USER, or a $ASG command is 
used. 

3. Each LOG command issued enters a new UIC into the system and 

automatically deletes the one entered previously (see also 
$DLG) . A UIC must consist of exactly three alphanumeric 
characters in any combination except "???", "PAG", "BNK", 

"SYS", "PER", "lOS", and "CTP". 


EXAMPLES : 

$LOG»_jFIL 

$LOGt_jEEM 
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6.23 $LST 


FUNCTION: The $LST card is used to output the contents of an ASCII 

file on the line printer. 


FORMAT: $LSTi_if ile-name : device (uic) 


ARGUMENTS: file-name = (Default - FILTMP SRC) This ten character 

field specifies the source name and extension 
of the file to be listed. 

device = (Default - System Device) This four character 
field specifies the device type, and handler 
version of the device on which the file to be 
listed is present. 

uic = (Default - Current UIC) This three character 
field contains the name of the UFD the file 
is on. It is required when the file device 
is a disk. 


EXAMPLE ; $LSTi— lOPRTFLt-iSRC : DPAl (EEM) 
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$MAC11 


6.24 $MAC11 


FUNCTION : 


The $MAC11 card calls the PDP-11 MACH assembler and 
the line editor. 


FORMAT: $MAC11; options filename-1: Device-1 (uic-1) ; filename-2: 

Device-2 (uic-2) ; Device-3. 

Line Edit Cards, or Source Cards, or next BCL command. 


ARGUMENTS: Options - (Default — B,L) A six character option. The 

options with their associated actions are given below: 

B = Generate binary paper tape 

L = Generate a listing on the requested output device 


filename-1 
device-1 (uic-1) 
filename-2 
device-2 (uic-2) 
device-3 


Source file (edit output/new filename) 

Standard format 

Edit input (old filename) 

Standard format 

Listing device - must not be directoried 


TECHNICAL NOTES: 

1. The $MAC11 command provides the user with the sumbolic pro- 
gramming capabilities of the MACH assembler which includes 
a macro instruction generator. 

2. If the line editor is to be used, the following rules should 
be followed: 

a. DECdisk, disk pack, or disk cartridge must be used for 
input/output , or the following error message will be 
printed : 

'NON-DISK I/O DEVICE' 

and an exit to the next control card will occur. 

b. The same device/unit should be assigned to device-1 and 
device-2. If not, the following message will be printed 
and an exit to the next control card will occur. 

'DIFFERENT DEVICES ASSIGNED TO .DAT -14 and -15' 
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c. The same .UFDT must be used for UIC-1 and UIC-2, other- , 
wise, the following error message will be printed and 
an exit to the next control card will occur: 

'DIFFERENT UIC ASSIGNED TO .DAT -14 and -15' 

3. The $MAC11 command can be used to: 

a. Assemble a file already existing. The $MAC11 card must 
specify filename-1, and the next control card should 
follow the $MAC11 command. 

b. Create a new file and assemble it. The $MAC11 card must 
specify filename-1, and the "source" deck should follow 
this command. 

c . , Assemble without creating a file. No filename should be 

specified and the "source" deck should follow the $MAC11 
command . 

d. Edit an already existing file and assemble it. The file- 
name-1 must be specified and line-edit commands should 
follow the $MAC11 command. 

e. Edit an already existing file, create a new "edited" file 
and assemble the newly created file. The original source 
filename is specified in filename-2. The new source 
filename is specified in filename-1, and the $MAC11 com- 
mand should be followed by the line-edit commands. 


Depending upon which function (see options above) , the $MAC11 command 
specifies, the command can be followed by: 

A MACll source deck, 

Line-Edit commands. 

The next Control Card 
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$MAP 


6.25 $MAP 


FUNCTION: The $MAP card is used to create an executable absolute 

file without overlays (to CHAIN resident code only) . 


FORMAT : 


$MAPi_if ile-name-1 ; option; file-name-2 


ARGUMENTS: file-name-1 


options 


file-name-2 


(Default - TMPXCT) This field is used to 
specify the executable file name of the 
file to be created by CHAIN. It is a 1 
to 6 character file-name. 

This field specifies CHAIN options. 

See the CHAIN XVM/EXECUTE XVM Util- 
ity Manual for the options and their 
description. 

(Default - FILTMP) This field consists 
of a file-names separated by commas. This 
list is passed to CHAIN as the response 
to CHAIN'S DEFINE RESIDENT CODE" inquiry. 


TECHNICAL NOTES: 

1. The $MAP command is used to CHAIN resident code only. It is 
a "Direct Substitution" c oii u l la nd used to create an executable 
absolute file without overlays. 

2. The $MAP, and $OVL commands produce a "load module" (absolute 
file) with a file extension of XCT. This module must be 
executed using the $XCT command to run the user's object pro- 
gram. 

3. CHAIN requests a list of resident routines. All routines 
listed and any library routines they may call remain in core 
throughout a run. The first resident routine is the program 
to which initial control of the execution of the system is 
given. All other routines in the system are either subroutines 
or co-routines. Resident subroutines may be called by any 
routine; therefore, the names assigned to resident routines 
must be unique throughout the system. 

4. See the CHAIN XVM/EXECUTE XVM Utility Manual for detailed 
information. 

Example : 

$MAPi_iEXECUT; ; MAIN , SUB 1 , SUB 2 , SUBS 

5. More than one option can be specified. Options should be 
separated by commas. 

Example: 


$MAPt_jEXECUT; SZ, PGR; MAIN, SUBl, SUB2 
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$F1IC 


6.26 $MIC 


FUNCTION: The $MIC card is used to LOGIN the Monitor Identification 

Code (MIC) . This is a privileged command used to lift 
all file protection. 


FORMAT: $MICujCode 


ARGUMENT: code = (Designated via SGEN) 


TECHNICAL NOTES: 

1. The $MIC is a three letter code used to lift all file protec- 
tion and to allow the system maintainer to access all disk 
files. If the correct code is used with the $MIC command, 
all files can be accessed. When an incorrect code is used, 

a $DLG (LOGOUT) function is performed and a job abort is 
entered into the Accounting File. 

2. This command provides the user with unrestricted supervisory 
access to all files contained in the various directories on 
the disk. The MIC of each system, as initially supplied to 
the user, is "SYS". As with $LOG, a $MIC command is deleted 
from the system using the $DLG or a new LOG command. 

3. The MIC user is usually the system owner. He can easily 
change the MIC code via system generation to maintain code 
integrity. 

4. The $MIC command is not echoed. 


6-44 




Control Commands 


$MNT 


6.27 $MNT 


FUNCTION: The $MNT card instructs the operator to mount a specified 

Tape on a specified Unit and to switch the WRITE function 
to LOCK or ENABLE. 


FORMAT: 


$MNT; 



i_itape-number ; drive-number ; 


LOCK *1 
ENABLEJ 


ARGUMENTS: D = (Default -DECtape) The one character 

option field specifies DECtape when it 
contains "D" . 

M = The one character option field specifies 
Magtape when it contains "M" . 

tape-number = This _< IO^^q character message field 
identifies the "reel" to be mounted. 

drive-number = This message field identifies the physical 
drive/unit (0-8) to mount the tape on. 

LOCK = (Default - LOCK) Tells the operator to 
WRITE LOCK the physical device. 

ENABLE = Tells the operator to WRITE ENABLE the 
physical device. 


TECHNICAL NOTE: 

1. The $MNT command instructs the operator to mount a tape reel. 

At the end of the message, the computer waits for the operator 
to mount the tape and then to type CTRL P to resume operation. 

The run-time-clock is suspended during this period, not the time- 
of-day clock. 


EXAMPLES : 


$MNT ; Mi_jCMS 40 ; 1 ; ENABLE 
$MNT ; Dl_jTID-REV-4 ; 3 ; 
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$f1SG 


6.28 $MSG 


FUNCTION: The $MSG card permits messages to the operator. 


FORMAT: $MSGi_imessage 


ARGUMENT: message = Any text (_< 72 characters/card) . 


TECHNICAL NOTES: 

1. The $MSG command provides a way for a user of BOSS to convey 
messages to the operator. 

2. Message information beyond the usable characters/card should 
be added via additional $MSG cards. 

3. User messages are output to the teleprinter. 

4. If a message and "wait" operation is desired the user should 
use a $MSW card. 

5. The syntax for this command is determined by Direct Substitution 
File format. 
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$F1SW 


6.29 $MSW 


FUNCTION: The $MSW card permits messages to the operator to be 

followed by a wait condition. 


FORMAT; 


$MSWi_jmessage 

(CTRL P at console teleprinter) 


ARGUMENT: message = Any text (£ 72 characters/card) . 

(fP) = The computer waits for a CTRL P from the 
console teleprinter to resume operation. 


TECHNICAL NOTES: 

1. The $MSW command is like the $MSG command; except, at the end 
of the message, the computer waits for a CTRL P from the 
console teleprinter to resume operation. 

2. User messages are output to the teleprinter. 

3. Message information beyond the usable characters/card should 
be added via original $MSG cards concluding with a $MSW card. 

4. The syntax for this command is determined by Direct Substitu- 
tion File format. 

5. The run-time clock is suspended from the time the $MSW command 
is issued until the operator answers with a CTRL P. 
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6.30 $NDR 


FUNCTION; The $NDR card is used to refresh a file directory. 


FORMAT: $NDRi_idevice (uic) 


ARGUMENTS: device = (Default - System Device) This four character 

field denotes the device type, handler version, 
and unit number. Thd default for the handler 
= A, and the unit number = 0 for MT or DP or 
RK or DT or DK. 

uic = (Default - Current UIC) This three character 

field denotes the User Identification Code (UIC) 
to associate with the corresponding device. 


TECHNICAL NOTES; 

1. The $NDR command causes the directory on the unit specified 
to be refreshed, or renewed; consequently all files on that 
unit are lost. The $NDR command and the $DIR command follow 
the same syntax. See PIP commands: $N, $D, and $R for addi- 
tional directory utilities. 

2. Care must be taken to ensure that needed files are not lost. 

3. UFD's set up or initialized using this command are automati- 
cally assigned a default protection code which does not over- 
ride, but enables the protect function of individual files 
(see $PCD command) . In a protected directory, only the user 
logged in under the UIC of the UFD (or the MIC) may write 
into the UFD. 


EXAMPLE: 


$NDRi_jDK (EEM) 
$NDRi_iMTA5 
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$0VL 


6.31 $OVL 


FUNCTION: The $OVL card is used to create an executable absolute 

file with overlays. A $LNK command should follow the 
$OVL command . 


FORMAT : 


$OVL. .file-name-1 ; option: file-name-2 


ARGUMENTS : 


file-name-1 = (Default - TMPXCT) This field is used to 
specify the executable file name of the 
file to be created by CHAIN. It is a 1 to 
6 character file-name. 


options = (Default - SZ) This field specifies CHAIN 
options. See the CHAIN XVM/EXECUTE XVM 
Utility Manual for the options and their 
descriptions . 

file-name-2 = (Default - FILTMP) This field consists of 
a list of file-names separated by commas. 
This list is passed to CHAIN as the res- 
ponse to CHAIN'S "DEFINE RESIDENT CODE" 
inquiry. 


TECHNICAL NOTES: 

1. The $OVL command is a "Direct Substitution" command used to 
create an executable absolute file with overlays. 

2. When a user's program has been successfully assembled or com- 
piled, the output is a relocatable "object module" (BIN exten- 
sion) . This module can be further processed by using the $OVL 
and $LNK commands. These commands will produce a "load module" 
(absolute file) with a file extension of XCT. The XCT file is 
actually two files, one with an XCT extension and the other 
with an XCU extension. The load module must be executed using 
the $XCT command to run the user's object program. 

3. With $OVL, the user generates (via CHAIN) a system of overlays 

a resident main program which may include resident subprograms, 

a resident blank COMMON storage area, and a set of subroutines 

which overlay each other at the user's request. Subroutines 
are organized via the $LNK command into units called LINKS 
which may overlay each other. Several LINKS may overlay as 
larger LINK without overlaying each other. A LINK is called 
and it remains resident until overlaid. A LINK'S core image 

is not recorded or "swapped out" when it is overlaid. The 
same image is brought into core each time a LINK is loaded. 

4. See the CHAIN XVM/EXECUTE XVM Utility Manual for detailed in- 
formation. 

EXAMPLE: See $MAP comments. 
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6.32 $paG 


FUNCTION: The $PAG card selects PAGE Mode system operation (4K) 


FORMAT: $PAG 


TECHNICAL NOTES: 

1. The default addressing mode is established at System Genera- 
tion time by the user. 

2. In PAGE Mode, relocatable system programs and user programs 
(including device handlers) are loaded within 4K memory pages, 
and Index Register usage is permitted. A $PAG card sets the 
system to operate in PAGE Mode. Conversely, a $BNK card sets 
the system to operate in BANK Mode. 
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$PRT 


6.33 $PRT 


FUNCTION: The $PRT card is used to alter the default value of the 

file protection code. 


FORMAT: 


$PRTi_i 



ARGUMENTS: File Protection Codes: 

Code Function Description 

1 = Unprotected - Unprotected files can be either 

read from or written into by 
any user. "Writing into" a 
file implies the use of a 
random-access MACRO .RTRAN. 

The file can be completely 
altered, but it cannot be 
deleted from a protected UFD, 
and it's length may not be 
changed. 

2 = Write Protected - Write protected files can be 

read by any user. 

3 = Read/Write Protected- Read/Write protected files 

cannot be read or written. 


TECHNICAL NOTES: 

1. The various levels of file protection provided are effective 
only when the UFD in which the file resides is not associated 
with the UIC currently in effect, and the UFD itself is pro- 
tected. Three file protection codes are provided, as described 
above . 

2. The $PRT command is used to alter the default value of the file 
protection code, set at System Generation or via the $N command. 
The default file protection codes set by this command remain 

in effect until another $PRT command is given or until the 
user issues a $DLG (which resets the protection code to the 
system's default value). The default value of file protection 
code for the system, as initially supplied, is two (2) . 


EXAMPLE: $PRTi_i2 
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6.34 $QDP 


FUNCTION: The $QDP card initiates a core dump (control Q area) 

when a terminal error (lOPS) is detected. The occurrence 
of the condition is based on the placement of the card 
within the deck. 


FORMAT: $QDP 


TECHNICAL NOTES: 

1. The $QDP command instructs the monitor to automatically give 
a core dump listing when a terminal lOPS error is detected. 
This command interrupts the program currently running, enters 
the contents of core into the QAREA on the System device, then 
lists this file on the line printer. 

2. The control Q area size is established at System Generation. 
The Control Q function dumps the minimum of the IQ area size 
and the current system memory size. 
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6.35 $RUN 


FUNCTION: The $RUN card takes a file that is located on the 

disk, does a Fortran compile of it, and begins to exec- 
ute the program. This is an efficient combination of 
the $FOR, $MAP and $XCT cards. 


FORMAT: $RUN file-name-1 = Device-1 (uic-1 ) 


ARGUMENTS: File-nam.e-1 = This is a Fortran source coded program. 

located on Device-1. 

Device-1 = (Default-System Device) This field is used 
to specify the desired source file input 
device. 

uic-1 = (Default-current uic) This field is used 
if device-3 specifies disk as the input 
device. 


TECHNICAL NOTES: 

1. Once a program has been compiled and runs, the only other 
command needed to rerun the same program is $XCT. 

First Run Next Run 

$JOB TEST 7 BLR $JOB TEXT; BLR THIS IS MUCH 

$RUN TEST $XCT TEST FASTER FOR THE 

SECOND RUN 

DATA DATA 

$END $END 

2. The system device is utilized for all intermediate files. 
The resulting binary and XCT/XCU files are resident there. 



6-53 




$XCT 


Control Commands 


6.36 $XCT 


FUNCTION: The $XCT card is used to execute an executable absolute 

file previously created by $MAP or $OVL commands. 


FORMAT: $XCT file-name : device (uic) 


ARGUMENTS: file-name = (Default - TMPXCT) This ten character field 

specifies the execute file name of the user's 
load module. 

device = (default - System Device) This four character 
field denotes the device type, handler version, 
and unit number of the device the execute 
file is on. 

uic = (Default - Current UIC) This three character 
field denotes the name of the UFD the file is 
on. It is only required when the file device 
is a disk. 


TECHNICAL NOTE: 

The $MAP and $OVL commands produce a "load module" (absolute 
file) with a file extension of XCT. This module must be 
executed using the $XCT command to run the user's object 
program. 

This command should not be confused with the BOSS End-of-File 
($) function. The $ only card is used to tell BOSS to run the 
Run-Time-File as it stands. The RTF is composed of BCL cards. 
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6.37 $XVM 


FUNCTION: The $XVM card enables and disables XVM mode. 


FORMAT: $XVM 


ARGUMENTS: ON = Enables XVM mode for user programs 

OFF = Disables XVM mode for user programs. 

TECHNICAL NOTE: 

1. This card should be used only on a system with the XM-15 
hardware option. 
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CHAPTER 7 

OPERATING PROCEDURES 


7 . 1 INTRODUCTION 

This chapter provides general operating procedures and considerations 
to assist users in operating in the BOSS XVM environinent . Procedures 
for system startup and system generation are not included here. The 
discussions and examples in this section assume a properly configured 
and running system. The reader should be familiar with BOSS command 
cards, the keyboard commands, and the different types of I/O device 
handlers and their versions. 

Specific operating procedures for the system programs (i.e., command 
strings, options, functions, error message, etc.) are provided in the 
various language and utility program manuals provided for XVM/DOS. 

In general, keyboard operations at initial startup consists of issu- 
ing commands to set up system operation prior to calling system and 
user programs via BOSS card commands. 

7.2 LOAD BOSS XVM 

To load BOSS, load the XVM/DOS Monitor first, via the bootstrap. 

Place the proper bootstrap (DECdisk or Disk Cartridge or Disk Pack) 
in the Paper Tape Reader. Set Address to X7637 (X = highest bank 5 
or 7) . Press STOP and RESET, then READIN. To restart the bootstrap, 
set ADDRESS to X7646, and press STOP and RESET, then START. The Mon- 
itor responds with XVM/DOS Vnxnnn and requests a date (mm[/]dd[/]yy) . 
After the Monitor replies with a "$", the user should enter "TIMEi_jhhmm 
then "BOSS " at the keyboard to call the Batch Monitor. If spooling is 
desired on a UC15 system, it should be enabled prior to calling "BOSS ". 
This is done as follows: 

XVM/DOS Vnxnnn 

$ SPOOL (Load and execute the SPOOL program) 

SPOOL XVM Vnxnnn 

RK UNIT # (0) (Specify the unit to spool on.) 

BEGIN ? (Y) Y (Initiate spooling) 

SPOOLING ENABLED 

XVM/DOS Vnxnnn 

Spooling is controlled only via XVM/DOS to protect users from harming 
each other. 
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Hereafter, all occurrences of card reader/line printer will refer to 
the actual device on non-UC15 systems and to the virtual device on 
spooled UC15 systems. 

7.3 BOSS XVM OPERATION 

On initialization, the batch monitor will be given control and immed- 
iately start processing jobs from the card reader. The card reader 
should be loaded with cards and the line printer with paper. 

If no cards are in the card reader, the message: 

I OPS 4 CD NOT READY 

will be output on the console teleprinter. The computer will then 
enter a "wait" state. To resume operation, the card reader must be 
loaded and "readied". If the card reader is a DIGITAL XVM(XVM) device, 
CTRL R must be pressed on the console teleprinter to resume operation. 

If it is a UNIBUS device, operation will resume automatically, once the 
device is readied, without requiring the keyboard entry of CTRL R. This 
distinction holds as well between XVM and UNIBUS line printers. 

From this point on, system operation is automatic. The operator must 
resupply the card reader with jobs and make sure the line printer has 
paper. When an I0PS4 occurs during a user's program execution, BOSS'S 
Time-Out feature^ is operative. If the operator fails to resume oper- 
ation within the time limit set via the $JOB command, the current job 
will be aborted. The following error message will be printed at both 
the teleprinter and line printer: 

TIME ESTIMATE EXCEEDED 

An aborted job will cause the System to process the next job in the job 
string without processing the current job. The aborted job, when cor- 
rected, can be reinserted at the end of the job string for processing. 

For each $JOB card, a record of each job processed will be output to 
the teleprinter in the following format: 

LOG JOB job i.d. BEGIN TIME 

(Marks beginning of job, no operation action required) 

When the card reader reads a card with an illegal punch, operation is 
suspended, and the message will be output on the console teleprinter. 
This error will occur on any code not specific to DEC026 or DEC029 
card code. The operator can repunch the card in question and insert 
it into the card stream, or discard it. By typing CTRL R on the 

■’’BOSS allows a run time control specification on the $JOB card. Should 
a job exceed the run time indicated (default is one minute) , BOSS will 
skip through to the next $JOB card. 
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control teleprinter, if this is a XVM card reader, he will cause the 
operation to resume. 

Jobs can be stacked in the card reader, and will be started and 
cleared automatically. Each job will be accompanied by line printer 
output, so the operator can monitor job processing. 

If a card command is in error (does not correspond to a Procedure File) , 

BOSS assumes that the command is the name of an absolute file (ABS) 
to be loaded. It then tries to load that file. If it doesn't exist, 
BOSS outputs the message: 

ILLEGAL COMMAND 

7 . 4 OPERATOR MESSAGES 

Messages to the operator can be output on the console teleprinter. 

These messages are of two general categories: 

1. Log messages (implementation via $MSG, $MSW, $JOB and $MNT 
commands) 

2. Monitor error messages system generated 
7.4.1 LOG Messages 

LOG messages start with the word 

LOG. . .msg. . . 

Its purpose is to instruct the operator and to request special action 
(i.e., tape mounting message via $MNT command, etc.). 

A variation of the LOG message (via $MSG) is the LOGW message. The 
LOGW message (via $MSW) begins with the word: 

LOG. . .msg . . . 

LOGW messages require operator action. At the end of the message, 
operation will be suspended. The teleprinter bell will be rung to 
signal the operator and tP will be output on the control teleprinter. 

The operator translates into action the instructions in the LOGW 
message, and at completion resiimes operation by keying in CTRL P on 
the control teleprinter. From the time fP is output on the control 
teleprinter to the time the operator types CTRL P, job timing is 
suspended. The real-time clock continues to run. The system will 
keep track of the time of the day, but the time spent waiting for the 
operator will not be charged to the current job. 

Two standard LOG and LOGW messages are as follows ; 

1. LOG JOB job i.d. BEGIN TIME 

Marks the beginning of a job; no operator action required. 

2. LOGW MOUNT {°}-TAPE tape i.d. ON DRIVE drive 

M ^ ENABLE 

Instructs the operator to mount a specified tape (M for 
Magtape, D for DECtape) on a specific unit. The operator 
must type CTRL P to resume operation. 
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Additional standard messages with their particular System/Job responses 
are shown in Table 7-1. 


TABLE 7-1 

BOSS ERROR MESSAGES 

Line Printer Messages 

DIFFERENT ADD FILE^ 

END OF RUN TIME FILE REACHED BY USER^ 

ILLEGAL COMMAND^ 

ILLEGAL COMMAND CARD SEQUENCE^ 

ILLEGAL COMMAND FOR ADD FILE^ 

ILLEGAL .GET BY USER^ 

ILLEGAL PROC FILE^ 

LINE TOO LONG^ 

LOAD ERROR- ILLEGAL .DAT SLOT^ 

LOAD ERROR- INPUT DATA ERROR^ 

LOAD ERROR-MEMORY OVERFLOW^ 

LOAD ERROR-NONEXISTENT SYSTEM PROGRAM^ 

LOAD ERROR-PROGRAM >4K^ 

LOAD ERROR- UNRESOLVED GLOBALS ^ 

NON-EXISTENT ADD FILE^ 

OPERATOR ABORT ^ 

PROC FILE READ ERROR^ 

RUN TIME FILE TOO LONG^ 

TERMINAL ERROR nn message 

Expanded message 
Standard = ujCAL address 

Expanded = ,CALaddress ,DEVu, message ,CALfunction , 
UIC, filename 

TERMINAL ERRORS = lOPS ERRORS (see Table 7-2) 

TIME ESTIMATE EXCEEDED^ 

USER DID A .PUT (core dump on LP) ^ 


^Go to next JOB (Job Abort) 

^Go to next Control Card. 

Note; Job abort conditions are recorded in 
Accounting File. 


Console Teleprinter Message 

MAX NUMBER OF ACCOUNTING FILES REACHED 
PLEASE PROCESS AND DELETE THEM 

Note: Jobs are not aborted but succeeding Accounting 

File entries are truncated. 


7.4.2 lOPS Error Messages 


The lOPS messages always indicate an error condition but no action is 
required by the operator except for IOPS4 messages. I0PS4 messages 
indicate that an I/O device is not ready; for example, a DECtape 
drive is not "write enabled" and should be. Then an I0PS4 message 


WXXX >^UU^UU \^KJ Cl UWJ. . 


i^xlXS tlriv 
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write enable the DECtape drive and then type CTRL R to resume operation 
The two standard I0PS4 messages for the Card Reader (CD) are as 
follows : 

1. I0PS4 CD NOT READY 

Indicates device status condition (e.g., light check, 
stacker full, hopper empty, etc.) and operation 
suspended. CTRL R to resume operation. 

2. I0PS4 CD ILLEGAL PUNCH 

Card reader attempted to read card with illegal 
punch (a non DEC 026 or 029 code) , The operator 
should initiate corrective action and type 
CTRL R to resume operation. 


The IOPS4 LP (Line Printer) message indicates an off-line condition 
or that the printer is out of paper. The System will remain in a wait 
status until these conditions are corrected. 


lOPS error messages other than I0PS4 are output to the line printer 
as a TERMINAL ERROR message. These are essentially XVN/DOS lOPS 
messages, in a batch environment, which abort the current job. The 
message format is as follows; 


TERMINAL ERROR nn 

Standard = 
Expanded = 


r Standard message^ 

^Expanded message"' 

i_j CALadr 

, CALadr , DEVu , CAL fen , UIC , f i lename 


TERMINAL ERRORS = lOPS ERRORS 


where nn = error code number (see Table 7-2) 


7 . 5 ABORT OPERATION 


At any point, the operator can issue an unsolicited command to abort 
the current job. This is done by typing CTRL T. It is important to 
note that this action will abort the current job and the System will 
search for the next job in the input stream. The message: 

OPERATOR ABORT 


is output on the line printer, and also recorded on the accounting file 
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TABLE 7-2 

TERMINAL ERRORS (lOPS) 


Code 

Function 

0 

Illegal CAL function code 

1 

CAL* illegal 

2 

.DAT slot error 

3 

Illegal Interrupt 

4 

I/O device not ready 

5 

Setup CAL issued with no skip chain entry 

6 

Illegal handler function 

7 

Illegal Data Mode or attempt to change from non-file 
oriented to file oriented I/O. 

10 

File still active 

11 

.SEEK/. ENTER/. RAND/. INIT not executed 

12 

Terminal Device Error 

13 

File not found 

14 

Directory full 

15 

Device full 

16 

Output buffer overflow 

17 

Too many files for handler 

20 

Disk hardware failure 

21 

Illegal block number 

22 

Two output files on one tape unit 

23 

Illegal Word Pair Count on attempt to transm.it more than 73 
characters 

24 

Illegal Unit Number 

25 

Negative or 0 character count (lOPS ASCII write) x or y 
Increment too large ( 2**14) (Binary Write) 

27 

Illegal write type 

20 

API software level not serviced 

31 

Nonexistent memory reference 

32 

Memory Protect violation 

33 

Memory Parity error 

34 

Power fail with no user-defined save routine 

35 

Attempt to recover from error caused an error. 

37 

Print line overflow 

40 

Header label error (Magtape) 

41 

Directory format error - (Magtape) 

42 

Accessibility Map overflow (Magtape) 

43 

Directory recording error (Magtape) 

44 

Logical EOT found (Magtape) 

45 

Long input record (Magtape) 

46 

Attempt to delete system (SYS) file 

47 

Illegal Horizontal TAB (line printer) 

51 

Illegal User File Directory 

55 

No buffers available or no TCB available 

61 

Parity error in Directory, Bit Map, or RIB 

63 

Protected User File Directory 

64 

Protected File 

65 

Unrecoverable Magtape error or unrecoverable telecommuni- 
cations error 

66 

Relative Block not within file 

67 

Illegal DECdisk word transfer starting address or count or 
I/O buffer above 32K 

70 

Buffer size too small 

71 

Empty UFD 

72 

Input Parity or Write Check error 

73 

Null file name 

74 

Disk System File Structure degradation 

75 

Disk System File Structure degradation 

76 

Disk System File Structure degradation 

77 

Undersized or nonexistent CTRL Q Area 


Note: For more information, see XVM/DOS Users Manual 
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To leave batch mode and go back to single user interactive mode, an 
End-Of-File (EOF) card (12-ll-j?-l punches in column 1, or all rows 
punched in column 1) must be the terminating point in the job string. 

A CTRL C will unconditionally abort BOSS XVM and return control to the 
XVM/DOS monitor. 

7.6 EXAMPLES OF BATCH OPERATION 


In general, batch operation consists of adding BCL commands to one or 
more user source decks to set up serial system operation via card in- 
put. This usually involves at least the $JOB and $END control cards. 
The BOSS operating environment is illustrated in Figure 7-1. The basic 
I/O configuration for both System Operation and program execution is 
shown. The .DAT slots used in this figure are given as information 
only; the Procedure File automatically refreshes the Device Assignment 
Table with these slots for each system program load. Both the Proced- 
ure File and Run-Time File are co-resident on the system device (disk) . 
Device assignments for user-program execution must be made via the 
$ASG command prior to the $XCT command. 


The following sections present three examples of BOSS controlled job 
streams. Each example is the result of an actual Job execution. 


1 . Program Execution 

Example 1 illustrates a simple Job stream to load and execute 
a program residing on DECtape. 

2 . Program Control Functions 

Example 2 adds to the command functions used in Example 1 
and, in addition, illustrates the use of the ASSIGN and 
Buffer commands. 

3. CHAINTEST Example 

Example 3 is a more complex job stream. It illustrates as- 
sembly of a main source program and individual subroutines. 
The object routines are then linked together in an Overlay 
structure for execution. 

Refer to Figure 7-2 for the "Console Log" of the above examples. 


7.6.1 Program Execution Example 

Figure 7-3 shows the "Program Execution Job Deck" for this example. 

The identification for this job is TESTS. The job card also specifies 
an automatic time-out after 20 minutes. This job string asks for a 
DECtape to be mounted on unit 1 and then loads and executes ($XCT) an 
execute file from that tape. A message to the operator will be output 
on the teleprinter as follows: 

LOGW MOUNT D-TAPE# TESTl ON DRIVE# 1 - WRITE LOCK 
Then CTRL P must be depressed on the keyboard to resume operation. 
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Teleprinter I/O 


O XVM/DOS Vnxnnn 

$T 1145 - Operator Response 


O SB0SS15 


log J03 CHAINTEST BEGIN TIME 114512 


I0PS4 CD NOT READYtR 

log job TEST5 BEGIN TIME 1 14B42 


L0GI-; MOUNT D-TAPE# TESTl ON DRIVE# 1 - WRITE LOCK 


o tP - Operator Response 


O LOG JOB lOTESTl BEGIN TIME 114957 


O LOGW MOUNT M-T4PE# TESTl DATA ON DRIVE# 1 - WRITE LOCK 


tPLOGW mount M-TAPE# SCRATCH ON DRIVE# 0 - WRITE ENABLE 


O TP 

TPLOGW MOUNT D-TAPE# TESTl ON DRIVE# 1 


- WRITE LOCK 


o TP - Operator Response 


Q XVM/DOS Vnxnnn 
$ 
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Figure 7-4 shows the "Program Execution Job Listing" for this 
example. Job listings include the System identification 

XVM BATCH OPERATING SYSTEM Vnxnnn 

and a program message : 

STOP j2(j?pf0f0rpr 

The listing also presents Accounting File information as indicated by 
the five columnar headings. 

7.6.2 Program Control Function Example 

Figure 7-5 illustrates a job deck containing several program control 
functions. The job identification is lOTESTl. A time-out function 
of 20 minutes is indicated. The job is logged in under the User 
Identification Code "EHM" . 

Two tapes are requested by the mount=tape $MNT commands. 

An input tape "TESTIDATA" must be mounted on magtape unit 1 which 
must be in a write LOCK protect status. These requirements for the 
operator were in the form of a teleprinter message as follows: 

LOGW MOUNT M-TAPE# TESTIDATA ON DRIVE# 1 - WRITE LOCK 

A work tape "SCRATCH" was requested by the second $MNT card which 
generated the following teleprinter message: 

LOGW MOUNT M-TAPE# SCRATCH ON DRIVE# Q - WRITE ENABLE 

The third $MNT card requested a program tape "TESTl" via the following 
message : 


LOGW MOUNT D-TAPE# TESTl ON DRIVE# 1 - WRITE LOCK 

Note that the default assumption for the device type is a DECtape and 
not magtape. 

The job requests the above tapes be mounted and then assigns ($ASG) 
six .DAT slots to specific devices in order to perform the user's 
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Figure 7-3 Program Execution 


Job Listing 

SJ06 TEST5»20 - Job Card 


XVM BATCH OPERATING SYSTEM Vnxnnn - System Acknowledgement 

SMNT TEST U I 
SXCT TE8T5IDTI 

STOP 000000 _ Program Output 

SEND 

Note: This job asks for a DT to be mounted, then 

loads and executes a program from this tape. 

Accounting File 


I .D. l^ATt SI AKl r I YJ. i'.C 1 j, 

T't'^'Sr‘5 i-Ui/ 2b '7S 00:U7:S5 0):ud: 27 0u:di>:d2 


Figure 7-4 Program Executing Job Listing 
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program I/O. Buffers are assigned by the $BUF command for the total 
number of buffers required. Included in the number given in the $BUFuj7 
card is a buffer for the program tape TESTl indicated on the $XCT card. 
The number 7 does not include one additional buffer which is auto- 
matically assigned by the system for the Run Time File. 

The TESTl program is executed via the $XCT card. This program sorts 
card images from DECtape, magtape, and DECdisk. The new order is 
listed on the Line Printer as illustrated in Figure 7-6. 

Figure 7-6 illustrates the output listing for lOTESTl. All job 
control commands are echoed along with the program output listing and 
the Accounting File entries for lOTESTl. 

7.6.3 CHAINTEST Job Example 

The job deck shown in Figure 7-7 includes only those BOSS-15 commands 
required to control the assembly of those link segments necessary for 
an overlay structure and then to execute the CHAINTEST program. The 
reader should refer to Figure 7-8 for individual source programs. 

This example illustrates the following job conditions: 

1. $JOB command control. 

2. MACRO Assembly of: 

1 main program "MAIN" 

6 subroutines, LNKl-5 and "DUMMY" 

3. Create an OVERLAY structure via $LNK cards and a 
load module via the $OVL card. 

4. Execute the load module via the $XCT card. 

A core map and a running log of subprograms is illustrated in 
Figure 7-8 following the $XCT MAIN line. The final output for 
this job is the Accounting File for CHAINTEST. 
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Figure 7-5 Job Deck Illustrating Program Control Functions 


SJOB IOTCSn;20|00|EHM 


XVM BATCH OPERATING SYSTEM Vnxnnn 

SMNTIM TESTlOATAMflOCK 

SMNTIM SCRATCHf0;ENA8l.E 

SMNT TESnmUOCK 

SBUF 7 

SA8G 7I0PA 

SASG ii;0PA 

SASG 13IDPA 

SASG HIOPA 

SASG 12IMTF0 

SASG 3IMTF1 

SXCT TESTUDTl 


Figure 7-6 Print Listing Illustrating Program Control Functions 
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0.1872S1 

N8S0,GE7ZOSt3YC7Z60FQ 

A 

RANDOM 

3E8T 

DATA 

CARD 

2 


81UR5 8768X1 Z)*02 

B 

RANDOM 

TEST 

DATA 

CARD 

3 

0.2S1472 

6KUS8«XRE8,05K73iR35 

C 

RANDOM 

TEST 

DATA 

CARP 

4 

0,858929 

P*«HnHJ0B8N65D,XHSFM 

D 

RANDOM 

TEST 

DATA 

CARD 

5 

0.9308J7 

S30lySZ2E4NO0-«fK*8PM 

E 

RANDOM 

TEST 

DATA 

CARD 

8 

0.955078 

0SfR8P83NX7CTN8CJDB , 

F 

RANDOM 

TEST 

DATA 

CARD 

7 

0.259010 

tJUP,E|f6CV3iVg R4C2Y 

6 

RANDOM 

TEST 

DATA 

CARD 

8 

0.045381 

I (Y-QCX,940iB S,RTY8S 

H 

RANDOM 

TEST 

DATA 

CARD 

9 

0.392315 

4ASHR68JCV286PAZUFJ04 

X 

RANDOM 

TEST 

DATA 

CARD 

10 

0.252908 

PPU WJSC,lCCsC8HS04Ti 

J 

RANDOM 

TEST 

DATA 

CARD 

11 

0.455305 

MJXYS«X 1CEIX7CX,W10Z 

K 

RANDOM 

TEST 

DATA 

CARD 

12 

0.702827 

2 *5U) i^V*2( ♦MSiCUS 

L 

RANDOM 

TEST 

DATA 

CARD 

13 

0.572985 

C*HNS2E089R588*B,*6 B 

M 

RANDOM 

TEST 

DATA 

CARD 

14 

0.519518 

LE301 XSP2‘=2BUYNTO0 

N 

RANDOM 

TEST 

DATA 

CARD 

15 

0,870357 

8JA4EU C5$5V*TEKCMV97 

0 

RANDOM 

TEST 

DATA 

CARD 

18 

0,828808 

SS)RUY2SHX*J 93JQ2,,* 

P 

RANDOM 

TEST 

DATA 

CARD 

17 

0.472398 

4UD41AL2fXV8 ACLNpXB* 

Q 

RANDOM 

TEST 

DATA 

CARD 

18 

0.7S487S 

1QK5J4T6W)10 0CNZ1P80 

R 

RANDOM 

TEST 

DATA 

CARD 

19 

0,504135 

HG9WWBKPT8FV 2ZZZB4*A 

S 

RANDOM 

TEST 

DATA 

CARD 

20 

0.423322 

Y 2C0«SSHyZ. JX3UYTIG 

T 

RANDOM 

TEST 

DATA 

CARD 

21 

0,707022 

05ONI 4Z9D1, NEUO MXF 

N 

RANDOM 

TEST 

DATA 

CARD 

783 

0,557647 

VS1PHU098CKG 2S)«VAUy 

Q 

RANDOM 

TEST 

DATA 

CARD 

784 

0,018083 

UD 0 J51CX18 U 8)N»«R 

P 

RANDOM 

TEST 

DATA 

CARD 

785 

0.159888 

7U4P4J«N(8AR J8«QGCQi 

Q 

RANDOM 

TEST 

DATA 

CARD 

788 

0.942381 

GBNi|PWPB249 U*WE4S$F 

R 

RANDOM 

TEST 

DATA 

CARD 

787 

0,191825 

KP0HZK,AW)8Gg.ES2KJlD 

$ 

RANDOM 

TEST 

DATA 

CARD 

788 

0,810828 

055LSXV18V2 *L* JWU7 

T 

RANDOM 

TEST 

DATA 

CARD 

789 

0,778089 

ULi)L2iCA*02 XHiA.^lX 

U 

RANDOM 

TEST 

DATA 

CARD 

790 

0,148458 

3FU18S UUHI VRXABV8Z 

V 

RANDOM 

TEST 

DATA 

CARD 

791 

0,044180 

5M17EWTZ89B1 V»B «NV0 

w 

RANDOM 

TEST 

DATA 

CARO 

792 

0.874308 

GX 88YTC -JY 058YP9H 

X 

RANDOM 

TEST 

DATA 

CARO 

793 

0,114983 

0Y87W ♦BRIXB , CYiS QS 

Y 

RANDOM 

TEST 

DATA 

CARD 

794 

0.319315 

A-8RE3FYQ* E SXMiH8BQ 

z 

RANDOM 

TEST 

DATA 

CARO 

795 

0,115451 

9GX .JVM-ZON IJT 5MBJ 

0 

RANDOM 

TEST 

DATA 

CARD 

798 

0.208518 

3Z X8MY 83*B KAT880E 

1 

RANDOM 

TEST 

DATA 

CARD 

797 

0,170828 

QM*7SN8,*9i7 TSCUZ5Y 

2 

RANDOM 

TEST 

DATA 

CARO 

798 

0.480921 

PVHQ*2*1RX3W XmJl OC0 

3 

RANDOM 

TEST 

DATA 

CARD 

799 

0,405499 

XAi«4SftJ40MU HSA8PHQ 

4 

RANDOM 

TEST 

DATA 

CARD 

800 

,0TS 

11 







SEND 








JOH 1,1), 

;) A Tf*: 


srART 


K '1 U 1' i ' i 

r. 

Li ■’ i: 1 t 

iurtsri 

h\]M ' Jb 


2 3 : 1 9 ; 2 1 


^3:23: 2 5 

i) 

: ,,) bib 1 


Figure 7-6 (Cent.) Print Listing Illustrating Program Control Functions 
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Figure 7-7 CHAINTEST Job Deck (without source cards) 



Job 

Listing 



SJOB 

CHAINTESTI20IEHM 

- Job 

Card 




Job 

stream 

includes : 




1. 

Assembly ($ASM) 





One Main Program 
Six Subroutines 




2. 

Load Module with 





OVERLAY structure 
($OVL and $LNK) 




3. 

Execute Load Module 





Core Map 

XVM 

BATCH OPERATING SYSTEM 

Vnxnnn 


Program Output 

SASM 

MAIN 


- Assembly 

END 

OF PASS 1 





Figure 7-8 Listing, CHAINTEST Example 


7-15 











Operating Procedures 





Job Listing 

(continued) 

PAGE 1 


MAIN 

SRC 







•lOOEV 6 

.GLOBL WRITCiLNKl,LNK2,LNK3f RETURN 

00000 

R 



MAIN 

•INIT 6,lf0 

00000 

R 

001006 

A 

*6 

CAL^1*1000 6S777 

00001 

R 

000001 

A 

*G 

1 

00002 

R 

000000 

A 

*G 

0*0 

00003 

R 

000000 

A 

*G 

0 

00004 

R 

100027 

R 


JMS WRITE 

00005 

R 

000013 

R 


MAINLY 

00006 

R 

120043 

E 


JMS* LNKl 

00007 

R 

120044 

E 


JMS* LNK2 

00010 

R 

120045 

E 


JMS* LNK3 
.EXIT 

00011 

R 

000000 

A 

*G 

CAL 

00012 

R 

000015 

A 

*6 

15 

00013 

R 

006002 

A 

mainly 

006002 

00014 

R 

000000 

A 


0 

00015 

R 

466031 

A 


.ASCII /MAIN PROGRAM RUNNIN6/<15> 

00016 

R 

147100 

A 



00017 

R 

502451 

A 



00020 

R 

743644 

A 



00021 

R 

406324 

A 



00022 

R 

051252 

A 



00023 

R 

472351 

A 



00024 

R 

147216 

A 



00025 

R 

064000 

A 



00026 

R 

000000 

A 



00027 

R 

000000 

A 

WRITE 

0 

00030 

R 

220027 

R 


LAC* WRITE 

00031 

R 

040034 

R 


DAC BUFF 



000034 

R 

BUFF*. 

*2 






.write 6, 2, buff. 36 

00032 

R 

002006 

A 


CAL*2*1000 66777 

00033 

R 

000011 

A 

*G 

11 

00034 

R 

000034 

R 

*G 

BUFF 





*G 

.DEC 

00035 

R 

777734 

A 

*G 

• 36 

.WAIT 6 

00036 

R 

000006 

A 

«G 

CAL 66777 

00037 

R 

000012 

A 

*G 

12 

00040 

R 

440027 

R 


IS2 WRITE 

00041 

R 

620027 

R 


JMP* WRITE 

00042 

R 

000000 

A 

RETURN 

0 



000000 

R 


,EN0 MAIN 

00043 

R 

000043 

E 

*£ 


00044 

R 

000044 

E 

*E 


00045 

R 

000045 

E 

*E 


S2ZE-00046 

NO 


ERROR LINES 



SIZE>00046 

NO ERROR LINES 


Figure 7“S (COiit.) Ll&tXxzg, CKAINTEST Excuugle 
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Job Listing 

(continued) 

SASM LNKl 








END OF PASS 

1 






PAGE 1 


LNKl 

SRC 











.GLOBL LNKl, LNK4, WRITE 

00000 

R 

000000 

A 


INK! 

0 

00001 

R 

120016 

E 




JMS* WRITE 

00002 

R 

000005 

R 




LNKILV 

00003 

R 

120015 

E 




JMS* LNK4 

00004 

R 

620000 

R 




JMP* LNKl 

00005 

R 

004002 

A 


LNKILV 

004002 

00006 

R 

000000 

A 




0 

00007 

R 

462231 

A 




•ASCI! /LXNKl RUNNIN6/<15» 

00010 

R 

645542 

A 





00011 

R 

202452 

A 





00012 

R 

547234 

A 





00013 

R 

446350 

A 





00014 

R 

706400 

A 







000000 

R 




•END LNKl 

00015 

R 

000015 

E 

*E 




00016 

R 

000016 

E 

*E 




SZZE«00017 

NO 


ERROR 

LINES 



SZZEI00017 


NO ERROR LINES 

SASM LNK2 








END OF PASS 

1 






PAGE 1 


1.NK2 

SRC 











•GLOBL LNK2,LNK4, WRITE 

00000 

R 

000000 

A 


UNK2 

0 

00001 

R 

120016 

E 




JMS* WRITE 

00002 

R 

000005 

R 




LNK2LV 

00003 

R 

120015 

E 




JMS* LNK4 

00004 

R 

620000 

R 




JMP* LNK2 

00005 

R 

004002 

A 


INK2UV 

004002 

00006 

R 

000000 

A 




0 

00007 

R 

462231 

A 




•ASCII /LINK 2 RUNNIN6/<15> 

00010 

R 

645500 

A 





00011 

R 

311012 

A 





00012 

R 

252634 

A 





00013 

R 

472231 

A 





00014 

R 

643432 

A 







000000 

R 




•END LNK2 

00015 

R 

000015 

E 

*E 




00016 

R 

000016 

E 





SIZE>00017 

NO 


ERROR 

LINES 



SIZEi00017 


NO ERROR lines 


Figure 7-8 (Cont.) Listing, CHAINTEST Example 
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Job Listing 

(continued) 

SASH INKS 





END OF PASS 

1 




PAGE 1 

LNK3 

SRC 







.6L08L LNK3fLNK4, WRITE 

00000 R 

000000 

A LNK3 

0 

00001 R 

120016 

E 


JMS* WRITE 

00002 R 

000005 

R 


LNK3LV 

00003 R 

120015 

E 


JMS* LNK4 

00004 R 

620000 

R 


JMP* LNK3 

00005 R 

004002 

A LNK3LV 

004002 

00006 R 

000000 

A 


0 

00007 R 

462231 

A 


.ASCII /LINK 3 RUNNING/<15* 

00010 R 

645500 

A 



00011 R 

315012 

A 



00012 R 

252634 

A 



00013 R 

472231 

A 



00014 R 

643432 

A 




000000 

R 


.END LNK3 

00015 R 

000015 

E *E 



00016 R 

000016 

E «E 



SXZE-00017 

NO 

ERROR 

LINES 


SIZE«00017 


NO ERROR LINES 

SASH DUMMY 





END OF PASS 1 




PAGE 1 

DUMMY 

SRC 







.6L0BL DUMMY 

00000 R 

000000 

A DUMMY 

0 

00001 R 

620000 

R 


JMP* DUMMY 


000000 

A 


.END 

S1ZE*00002 

NO 

ERROR 

LINES 


SZZE«00002 


NO ERROR LINES 


Figure 7-8 (Cent.) Listing, CHAINTEST Example 
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Job Listing 

(continued) 

lASH LNK4 






END or PASS 

1 




PAGE 1 


UNK4 

SRC 








.6L0BL LNK4,LNKS, RETURN, MRITE 

00000 

R 

000000 

A LNK4 

0 

00001 

R 

200000 

R 


LAC LNK4 

00002 

R 

060017 

E 


DAC* RETURN 

00003 

R 

120020 

E 


JMS* WRITE 

00004 

R 

000006 

R 


LNK4LV 

00005 

R 

120016 

E 


JMS* LNK5 

00006 

R 

004002 

A LNK4LV 

004002 

00007 

R 

000000 

A 


0 

00010 

R 

462231 

A 


•ASCII /LINK 4 CALLED/<15> 

00011 

R 

645500 

A 



00012 

R 

321010 

A 



00013 

R 

340630 

A 



00014 

R 

462130 

A 



00015 

R 

406400 

A 





000000 

A 


• END 

00016 

R 

000016 

E «E 



00017 

R 

000017 

£ *E 



00020 

R 

000020 

E *E 



SXZE«00021 


NO 

ERROR 

LINES 



SZZE>00021 


NO ERROR LINES 

SASM UNK5 






END or PASS 

1 




PAGE 1 


UNK5 

SRC 








•GLOBL LNK5, RETURN 

00000 

R 

000000 

A LNK5 

0 

0000 1 

R 

220004 

E 


LAC* RETURN 

00002 

R 

040000 

R 


DAC LNK5 

00003 

R 

620000 

R 


JMP* LNK5 



000000 

A 


.END 

00004 

R 

000004 

E *E 



SIZE>00005 

NO 

ERROR 

LINES 



SZZEV0000S 


NO ERROR lines 


Figure 7-8 (Cont.) Listing, CHAINTEST Example 
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SOVL maznmhain 
sunk UlNKl-lNKl/OUHHY 
SUNK LZNK2«INK2/DUHMY 
SUNK LZNK1II.ZNK2ILNKS 
SINK (.NK4IINK5 
SINK 

SXCT MAIN 


- Create OVERLAY 


- Execute Load Module 


XCT fill 


- Begin Core Map 


OPTIONS & PARAMETERS 


RESIDENT CODE 


LINKS & STRUCTURE 

UINKl«LNKl/OUMMY 

LINK2»LNK2/0UMMY 

LINK1ILINK2ILNK3 

LNK4ILNK5 

link TABLE 

57S46-57636 00071 

RESIDENT CODE 

MAIN 57500*57545 00046 


LINK •* 

LINKl 

LNKl 57461-57477 00017 
DUMMY 57457-57460 00002 

LINK — 

LINK2 

LNK2 57461-57477 00017 
DUMMY 57457-57460 00002 


LNK3 57461-57477 00017 


LNK4 57436-57456 00021 


LNK5 57452-57456 00005 


rnsF 

'’57436-57636 00201 


Figure 7-8 (Cont.) Listing, CHAINTEST Example 
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Job Listing (continued) 


MAIN procram RUNNINS - Output from User Program 

lINKI RUNNING 
LINK a CAUED 
LINK 2 RUNNING 
UINK 4 CALLED 
LINK 3 RUNNING 
LINK A CALLED 
SEND 


CHAINTEST Accounting File 


J U ^ ,L , 0 , 

C A 1 :j T i£ S ]• 


oAo; 

'7b 


STAR I i i -Ut. 
2 3 : fc : 1 2 


r'.iO T 1. in, 
2 3 : 2 ^ : 2 o 


r< U 1 ■' r i >; t. 

' J i 0 b I 1 4 


Figure 7-8 (Cont.) Listing, CHAINTEST Example 


7-21 






CHAPTER 8 
RUN TIME FILE 

Most System programs run by BOSS are identical to those run by XVM/DOS. 
Exceptions are the Resident and Nonresident Monitors, and B.PRE, the 
preprocessor. The XVM/DOS System Manual describes those programs in 
detail . BOSS expands the information on Control Cards into a series of 
commands in the format used by the XVM/DOS system programs. Nonresident 
BOSS does this command expansion, and sorts the expanded commands in a 
disk file, known as the Run Time File (PRCFIL PRC) (see Figure 8-1) . 

Since XVM/DOS programs communicate with an operator at a teleprinter, 

BOSS feeds the expanded commands to the programs via .DAT slots assigned 
to the teleprinter. BOSS attaches DAT -2 to the Run Time File, and, un- 
less instructed otherwise, directs teleprinter output to the Line Printer. 
Macro programs can initiate I/O to the teleprinter by setting bit 4 in 
.SCOM+52 and proceeding with macros directed to TAA (see Table 8-1) . 
FORTRAN programs can do teleprinter I/O by calling TTON before any tele- 
printer I/O and calling TTOFF to resume line printer I/O to DAT slots 
assigned to TAA. (Program Termination causes an automatic TTOFF.) 


GENERAL PROCEDURE FILE FLOW 



Figure 8-1 General Procedure File Flow 
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Table 8-1 


•SCOM Table Entries 


.SCOM = location 
mg 

(For complete table see XVIVdos System Reference 
Manual) . 

.SCOM+j? thru +33 

(See XVM/DOS System Reference Manual) 

.SCOM+34 

Elapsed time in seconds 

•SCOM+35 thru +51 

(See XVM/DOS System Reference Manual 

.SCOM+52 

BOSS Mode Bit Register: 

Bit 0=1 BOSS Mode. 

1=1 Control Card Read by user, 5/7 

ASCII image saved in first block 
of NRBOSS. 

2=1 Resident BOSS reached "EOF" on run 
time estimate. 

3=1 User exceeded time estimate. 

4=1 I/O CAL to go to TTY. 

5=1 Terminal lOPS error by user. 

6=1 QDUMP to be given to user on lOPS 
error. 

7=1 Operator abort (Control T) . 

8=1 Job active. 

9=1 Exit from BOSS-15 Mode. 

10 = 1 User tried to do a .PUT. Core will be 

dumped and a listing given on LP . 

11 = 1 User tried to do a .GET. 

12 -13 Not defined. 

14 -16 .SYSLD error number. 

17 = 1 Job abort. 

•SCOM+53 thru +74 

(See SVM/DOS System Reference Manual) 

.SCOM+75 

Bit j? - 8 # of lines in RTF. 

9 - 17 # of lines READ in RTF. 

.SCOM+76 thru +77 

(See XVM/DOS System Reference Manual) 
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8 . 1 PROCEDURE FILES 

For each BOSS command there is a corresponding disk-resident ASCII 
file, called a Procedure File. The Procedure File contains XVM/DOS 
commands. When XVM/DOS (under BOSS) executes the commands in the Pro- 
cedure File, it carries out the function specified by the BOSS control 
card. The XVM/DOS commands in the Procedure Files contain fields (for 
instance, a file name) that are ordinarily filled in by the XVM/DOS 
operator at the teleprinter. Nonresident BOSS fills them in with text 
strings from the control card. These fields are called, "Variable 
Fields". Before executing the XVM/DOS commands contained in the Pro- 
cedure File, all the variable fields have to be resolved. This process 
is very similar to a macro expansion. The expanded XVM/DOS commands 
are put in a Disk File, called the "Run Time File (PRCFIL PRC)". The 
RTF can contain the expansion of one or more Procedure Files, up to 
777g lOPS ASCII records. 

BOSS expands Procedure Files strictly on a text string, character 
basis. It has no knowledge of the intrinsic function of each BOSS 
control card, except for $JOB and $END, $CRT, and $ADD ($END, $MNT, 
and $ADD have no Procedure Files) . 

8.1.1 Procedure File Format 

File Control Record 
FORMAT: [nnn] IcommentJ 

n = decimal number - 4) indicating control option 


Table 8-2 

Procedure File Option Classes 


File 

Options 

Option Class 

I 

II 

III 

Option 

Code 

0,3 

1,2 

4 


Options can be combined in any permutation 
but cannot include options from the same class. 

where: = Expanded substitution 

(default - without 3) . 

1 = Open-ended file (default - without 2) . 

2 = Closed-ended file (leading spaces ignored) . 

3 = Direct substitution (leading spaces ignored) . 

4 = Test Mode - echoes RTF lines on line printer. 

NOTE: (J, 3 and 1, 2 are illegal combinations. 
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In order to ensure successful expansion, all Procedure Files must 
follow a strict format. The first record of the Procedure File must 
be a control record, with parameter information. The first record 
may also contain comments, because BOSS interprets only pertinent 
infonnation , and ignores the rest. The numbers , 1, 2, 3, and 4 
specify different options. All other characters are ignored. The 
option digits can appear in any order, and anywhere on the record. 

The option specified by each number is given below: 

- Expanded Substitution (default, if "3" not given explicitly) 

This option specifies that the Procedure File is to be 
expanded according to the normal rules of substitution, 
which are given below. 

1 - Open Ended File (default, if "2" not given explicitly) 

This option instructs the Non-Resident BOSS Monitor to 
leave the Run Time File open after expanding the current 
Procedure File. BOSS then searches for the next control 
card . 

2 - Closed End File 

This option instructs Non-Resident BOSS to close the 
Run Time File after expanding the current Procedure File, 
and to execute the XVM/DOS commands in the Run Time File. 
Procedure Files corresponding to commands that may pos- 
sibly be followed by "Data Cards" should be of Type 2. 

3 - Direct Substitution 

This option indicates that BOSS should not expand the 
Procedure File according to normal rules. Refer to 
paragraph 8.1.2 for information on Direct Substitution. 

4 - Test Mode 

This option indicates that BOSS should echo the Procedure 
File expansion on the Line Printer. This allows a check 
on the Procedure File. 

The following combinations are illegal: 

0 and 3 

1 and 2 


If BOSS finds an illegal option combination, it will print, 
ILLEGAL PROC FILE 


and search for the next control card. 
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8.1.2 Source Control Records 


L = [K [V]^]’^ or [[V]^K]”^ 
where : 

L = Source Control Record (line) and succeeding records 
starting at the second line of the Procedure File. 

K = Constant. 

V = Variable in the following format: 

0XNN(K or V) 0 

where: 0 = Variable Record delimiter. 

X = O, A, D, U, denoting procedure fields: 

0 = Option field delimited from BCL 
Command Field by a semicolon. 

A = filename text: 

1 - delimited from BCL command 

or Option field by a blank. 

2 - delimited in all other cases 

by a semicolon. 

D = Device and unit BCL delimiter = 
a colon. 

U = uic BCL delimiter = (. 

NN = Decimal digits - 99 denoting a specific 
field in sequence. 

Expanded Substitution - includes the 
Option Field (0) and: 

Aj2(j? - AJ?9 
D0f)2f - D0T9 
- U^9 

Direct Substitution - - A99 starting 

at sequential order. A field can NOT 
appear more than once. (Exceptions are 
Dl(? - D17) 

Reserved field numbers are: 

Dll = System Device, 

D12 = Current uic, 

D13 = Carriage Return, 

D14 = Altmode. 

0 = Default Record delimiters. 

n & m = Repeat functions (Number of characters/ 
record not to exceed line length) . 


BOSS uses all other records in the Procedure File as macro definition 
records. Records after the first one are all Macro Definition Records 
For each such record, a record will be written in the Run Time File. 
Each Macro Definition Record has the same format. Two types of fields 
are used: K-fields and V-fields. K-fields specify constant character 

strings that will be written into the Run Time File exactly as they 
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appear in the Procedure File. V-fields specify variable character 
strings to be replaced by specified strings on the Control Cards. 

Each Macro Definition Line of a Procedure File can contain any number 
of K- and V-fields, in any combination. V-fields are delimited at 
@-signs. K-fields are delimited by adjacent V-fields, or the end 
or beginning of the record. Since there are only two types of fields, 
only one need have delimiters. Two adjacent V-fields, however, re- 
quire two adjacent @-signs and parenthesis. 

K-fields may be any string of legal lOPS ASCII characters, except the 
0-sign. 

V-fields 

A V-field has the following format: 



The two 0-signs delimit the field. The first part of the field 
(A, D, U or 0) is a card-position identifier, and must be present. 

It identifies the position on the current Control Card of the char- 
acter string to be substituted in the Run Time File. The legal com- 
binations are: 


AJ?j3f,AJ?l, A0f9 

Uj?J3f,UJ?l, UJ19 

Dj?}?,D0ri, Dj?9,Dig, . . .D17 

0 


With the exception of D10f through D17, each of the above position 
identifiers corresponds to a unique character string of the Contrc 
Card, according to the following scheme: 


$CMD:0 A0f|l:D0f0f(U0r0r) ; Aj?l : D0fl (Uj?!) ; ;A0T9:DJ?9 (U0f9) 


The D10f...D17 position identifiers do not correspond to character 
strings found on the Control Card, but rather to character strings 
defined by BOSS. Thus, 
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Dl{? - Unused 

Dll - .SIXBT representation of the System Device Code (DK or DP) 
D12 - Current Logged-in UIC 

D13 - .SIXBT representation of Carriage RETURN 

D14 - .SIXBT representation of ALT MODE 

D15 - Unused 

D16 - Unused 

D17 - Unused 

The parentheses in a V-field must be present. They are used to 
specify a default string. The default string is used in case the 
string on the Control Card specified by the position identifier is 
null. A set of parentheses must be included, even if the default 
string is null. The default string itself can be a variable, resulting 
in nested variables. 

8.1.3 Direct Substitution 

When processing a Direct Substitution Procedure File, BOSS places the 
fields on the Control Card into the Run Time File just as they stand, 
with only leading spaces ignored. That is, BOSS does not necessarily 
expect to find file names, and so on, as with normal substitution. 

Fields on the Control Cards are separated by semi-colons (;)/ and are 
processed in a serial manner. The ampersand (6f) is used for a special 
purpose. It causes the current record being composed for the Run 
Time File to be terminated with a Carriage RETURN, and written out, and 
a new record started. This is so that the limit of seventy-five 
characters per line will not be exceeded. 

There are only two legal field types within the Procedure File. They 
are as follows: 

1. through A99 

2. D10f through D17 (System Defined) 

In making up Direct Substitution Procedure Files, the following rules 
must be followed: 

1. The first line must contain a three (3) . This declares 
the file to be direct substitution. 

2. The "A" fields must appear in sequential order, starting 
at Aj?J?. Each "A" field can be used only once within the 
Procedure File- 
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3. The "D" fields can only be "Dl^" through "D17". They 
can be used any number of times, in any order. 

4. Variable expressions must follow the standard V-field 
format, as in expanded substitution. 


8.1.4 Example of Procedure File 


The following example shows a typical Direct Substitution Procedure 
File, the Control Cards used to call it and the resulting lines 
produced in the Run Time File (RTF) . 


Procedure File - MAP PRC 

1;3 DIRECT SUB FILE FOR CHAIN OPTION AND RES CODE ONLY 
CHAIN 

@A^2fj? (TMPXCT) 0(§D14 ( ) 0 
0A(?1 (SZ) 00D14 0 0 
0A0f2 (FILTMP) 00D14 () 0 
0D14 0 0 

Control cards as they appear: 

$MAP TEST1;SZ,BNK; MAIN, SUB 


Run Time File Lines: 

CHAIN<CR> 

TEST1<ALTM0DE> 

SZ, BNK< ALTMODE > 

MAIN, SUB<ALTMODE> 

< ALTMODE > 

< ALTMODE > 

NOTE: D14 =<ALTMODE> is an ALTMODE. 

8.2 SUMMARY - DIRECT SUBSTITUTION CONTROL CARDS 


1. Field Delimiters: 

SEMI-COLON (; ) ONLY 

2. Field Names: 

"A" FIELDS ONLY, AND IN SEQUENTIAL ORDER. 

Note: The appearance of an option field on the Control 

Card will cause an "ILLEGAL COMMAND" error to be printed on 
the Line Printer. 

3. Card Continuation: 

A Semi-Colon ( ; ) followed by a Carriage RETURN or ALTMODE 
with intervening spaces ignored. The field is not terminated. 
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4. Special Characters: 

The ampersand ( &) writes out the Run Time File line with a 
Carriage RETURN and starts a new Run Time File line. 

5. Procedure File 
First Line: 

A 3 must appear on this line. 

6. Fields: 

thru A99 in sequential order starting at Each 

field can be used only once. 

Dl^ thru D17 in any order and can be used any number of 
times . 
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TABLE 8-3 
FILE I/O STATUS 



These Procedure Files do not fall under the 
category 3 or 0 because there is no argument 
field, therefore no substitution takes place. 


Definitions of Procedure File Types 


1 Open End Type - The current run-time file remains open so 
that other Procedure Files can be expanded into the run- 
time file. 

2 Close End Type - The current run-time file is closed and 
control is passed to the Non-Resident Monitor. 

3 Direct Substitution - The various fields on the Control 
Cards are put directly into the current run-time file as 
they appear on the card, only the " ; " field delimiter 
is omitted. 

0 Expanded Substitution - The various fields on the Control 
Card are expanded per the procedure file into the current 
run-time file. 
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APPENDIX A 

QUICK REFERENCE TABLES 


A.l INTRODUCTION 

This Appendix contains tabularized data intended as an aid to recall 
for users who are familiar with the contents of the PIP XVM Utility 
Manual. Tables are supplied which describe the Primary PIP Operations, 
PIP Optional operations, optional functions permitted within each pri- 
mary operation, and the PIP command structure, plus a series of tables 
describing specific operations which may be carried out using PIP 
facilities. In some cases, the tables presented in this section are 
duplicates of those contained in the PIP XVM Utility Manual; this re- 
dundancy is necessary to make this manual a complete single source of 
information. 

A. 2 OPTIONS VERSUS PRIMARY OPERATIONS 

The matrix Table A-1 illustrates the optional PIP function switches 
permitted in each of the PIP primary operations. 

A. 3 PIP COMMAND STRING FORMAT CHARTS 

Figure A-1 illustrates the general format of the Destination/Source 
command string and the general format of the Single Device command 
string . 
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T I I DK I 1 DESTFL I i SRC i i (G) DTn i i DATA , i SRC) 


OPERATION 

COMMAND DESTINATION DESTINATION FILE OPTION .^SOURCE SOURCE FILE 

CHARACTER I I DEVICE I I (filename | | ext) | | SWITCH(S)^^ DEVICE I I (filename | | ext) TERMINATOR 



1 



$T = Transfer file 
$L = List directory 
$C = Copy mass 
storage 

$R = Rename file 
$3 = Block copy 

Optional for non- 
file oriented de- 
vices. Use 
commas to sepa- 
rate multiple 
file names and 
extensions 

Use commas to 

separate mul- y= Return 

tiple file control 

names and ex- to PIP 

tensions. ALTMODE = 

Return 
control 
to the 

PP = Paper tape punch 

DTn= DECtape unit 

TT = Teletype 

LP = Line printer 

MTn= Magtape 

DK = DECdisk 

VP = VP15A CRT display 

PR = Paper tape reader monitor 

TT = Teletype 

CD = Card reader 

DTn= DECtape unit 

MTn= Magtape unit 

DK = DECdisk 

DPn= Diskpack unit 


DPn= Diskpack unit RKn= Disk cartridge unit 

RKn= Disk cartridge unit 
XY = Plotter 


Data Mode 


Switches 


Function Switches 


A = lOPS ASCII 
B = lOPS Binary 
I = Image Alpha- 
numeric 

H = Image Binary 
D = Dump 


E = 
G = 
C = 

W = 
Y = 
N = 
Snn 


F = 
T = 
Q = 
M = 

L = 
P = 
V = 


Convert tabs to spaces 


to 


Flag bad parity lines 
Convert multiple spaces 
tabs 

Combine files 
Segment files 
New Directory 

= New directory with CTRL Q 
area. Size of area (nn) = 

8, 12, 16, 20, 24, 28, or 32 
(K words) N operation only. 

Default = current size of 
system. 

Insert Form Feed every 55,- 
lines or after .EJECT 

Delete trailing spaces ”) Input must be 

in punched 
card format 


Delete sequence numbe 




Request a listing of 
the system MFD 
Request a listing of the 
system SYSBLK directory 
Request UFD listing with 
RIB data 

Vertical Control 


BACK-ARROW 

»- = A Hollerith 0-5-8 

multipunched card code 
for 029 code or an 8-2 
multipunch code for 
026 code. 


Figure A-1 

PIP Command String Formats 
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A. 4 REFERENCE TABLES 


The PIP Tables are organized according to the following functional 
areas : 


Table Functions Described 

A-1 Options, available options versus primary operations. 

A-2 Directory Operations, how to set up, list, modify, 
and operate with disk (UFDJ and DECtape 
directories . 

A-3 List Operations, how to obtain printouts of 

directory and file information. 

A-4 File Modification Operations, how to modify 
and manipulate files and file contents. 

A-5 File Transfer Operations, how to transfer files 
between system storage devices. 

A-6 Copy Operations, how to copy device contents, 

large groups of files or data blocks from system 
mass storage devices. 

A-7 PIP Error Messages, how to interpret error 
conditions . 


No attempt is made to describe all possible operation/switch com- 
binations or applications. However, the user is provided with 
sufficient information to meet his reference requirements. 
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TABLE A-1 

AVAILABLE OPTIONS VERSUS PRIMARY OPERATIONS 


H H W N 

Eli Cm P-l O H 


ElI S O Eh c 




lOPS ASCII Data Mode 


lOPS Binary Data Mode 


Space to Tab Conversion 


Dump Mode 


Tab to Space Conversion 


Insert Form Feed 


Correct Bad Parity 


Image Binary Mode 


Image Alphanumeric Mode 


New Directory 


New Dir . with CTRL Q area 


Delete Trailing Spaces 


Delete Sequence Nos. (cards) 


Combine Files 


Segment Files 


Delete Current UFD 


List Unprotected UFDs 


Delete Truncated Files 


List Current UFD & RIB data 


List SYSBLK 


Vertical Forms Control 


^ Legal only with DECtape or Disk Pack or Disk Cartridge copy operations, 

^Legal only when the current password is the MIC. 

^Transfer, T, commands which include a Y option switch must be 
preceded by an S, segment command string. 




















































TABLE A-2 

DIRECTORY OPERATIONS 


PROCESS 

USE 

OPERATIONS 

OPTION 

1) 

Initialize the existing 
UFD or create a new UFD 
for the current UIC 

N , New 

None 

2) 

Initialize the existing 
UFD or create a new UFD 
for the current UIC 
during a T transfer 

T, Transfer 

(N) , (NA) , 
CNB 

3) 

Initialize or create a 
UFD for the current 
UIC with a specified 
UFD protection code 

N with code 

specified 

written 

(cd) 

4) 

Delete a file from the 
current UFD 

D, Delete 

None 

5) 

Rename a file in the 
current UFD and keep 
old protection code 

R/ Rename 

None 

6) 

Rename a file in the 
current UFD and set 
new protection code 

R , Rename 

(cd) 

7). 

Change protection code 
of the current UFD 

R , Rename 

None 

8) 

Initialize the direc- 
tory of a non-mass 
storage device 

N f New 
Directory 


9) 

Initialize mass storage 
device directory and set 
up a QAREA OF: 

a) System core size 

b) Specified size 


(S) 

(Snn) 


EXAMPLE 


$Ni_iDK 


$Ti_jDKi_-iDESTFL^DT1i-jSOURCE i_i(NA) 


$Ni-jiDKi_j(j3) 


$Di_j D Ki_iD E S TF L t_jB IN 

Note: Filename extension is required. 

$Ri_jD Ki-jNE WN AM t-jB IN-«- DKi_-iOLDNAMujBIN 
Note: Filename extension is required. 

$Ri-jDKu-jNEWNAMi-jBIN^DKi_iOLDNAMi_jBINt-j(3 ) 
Note: Protection code is specified 

within parentheses. 

$Ri_jDK»_j<JOE:jg> 


$Ni_iDTl 


$N|_jDTli_j CS) 
$Ni-iDTli_i (S3 2) 









Quick Reference Tables 









TABLE A^3 


LIST OPERATIONS 


PROCESS 

USE 

OPERATIONS 

OPTION 

EXAMPLE 

1) List the system MFD 

L, List 

(Ml 

$Li_jLP^DK i«jCM) 

2) List the UFD of the 
current UIC 

L, List 

None 

$Li_jiT’]>DK 

3) List the contents of 
an unprotected non- 
current UFD 

L, List 

<UIC> 

$L i»jTT<- DKu-J< JOE > 

4) List the system SYSBLK 

L, List 

CL) 

$Li«jTT«-DKi_jCL) 

5) List current UFD with 
File Protection Codes 
and RIB information 

L, List 

CP) 

$Li_jTT>-DKi«jCP) 

6) List directories of 
Mass Storage devices 

L, List 

None 

$Li_iTT^DT1 

7) List a selected file 
entry from the current 
UFD or device directory 

L, List 

None 

$L^ TT-f-DK FILNAM,_,BIN 

8) List a selected file 
entry from an unprotected 
noncurrent UFD 

9) List all file entries 
having the same filename 
extension from 

L, List 

None 

$L ^ TT-<-DK FILNAM ^ SRC ^ <JOE> 

a) the current UFD or 
device directory, 
or 

L, List 

None 

$L,_jTT<-DK #SRC 

b) an unprotected 
noncurrent UFD 

L, List 

<UIC> 

$L ^ TT-^DK^ #BIN ^ <JOE> 
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FILE MODIFICATION OPERATIONS 


PROCESS 

USE 

OPERATION 

OPTION 

EXAMPLE 

1) 

Rename a file 

R, 

Rename 

None 


$ R u_iDKi_jNEWN AMi__iB IN^ DKi_jO LDN AMu-jB I N 

2) 

Rename and set the 
protection code for 
a file 

R, 

Rename 

<UIC> 


$Ri_iDKl-iNEWNAMi_jBIN^DKi_jOLDNAMi_jBINi_j { 3 ) 

3) 

Delete a file: 







a) from current UFD 

D, 

Delete 

None 


$Di_iDKujF ILEAi_iB IN 


b) from unprotected 
UFD 

D, 

Delete 

<UIC> 


$Di_i DKi_j< JOE > i_iF 1 LEAcjB IN 


c) from mass storage 
device directory 

D, 

Delete 

None 


$D»-i DT li_j F I LE A i_jB IN 

4) 

Delete all truncated 
files from a UFD which 
is : 







a) current 

D, 

Delete 

(X) 


$Di_iDK i-4(X) 


b) specified 

D, 

Delete 

<UIC> 


$Di_iDKi_i< ABC> uJ (X) 

5) 

Convert multiple spaces 
to tabs 

T, 

Transfer 

CC) , 

(CA) 

$ Tu-iLPi_iDES TFL-<- DT 1 i_iS0URCE 1-1 ( CA ) 

6) 

Convert tabs to spaces 

T, 

Transfer 

CE) , 

CEA) 

$Ti-iLPi-iDESTFL'«-DTli-iSOURCE i— i(EA) 

7) 

Detect and correct 
File Parity and Check- 
sum errors 

T, 

Transfer 

CG) , 

CGA) 

$Ti_iDKujDESTFL-*-DT1i-iS0URCE i_i(GA) 

8) 

Delete Trailing Spaces 
from file contents 

T, 

Transfer 

(T) , 

(TA) 

$Ti-iDKi-iDESTFL-^DTli«iSOURCE i-j(TA) 

9) 

Delete sequence from 
file (card input or card 
format data files only) 

T, 

Transfer 

CQ) , 

(QA) 

$Tc-jD T li_j DES TF Lt_iS RC i-J CQ ) ^ CD 

10) 

Combine separate files 
into one file 

T, 

Transfer 

(W) 


$Ti— 1 DT 1 i_jLIBR i_i ( WB ) -t- DT 2 i_iF I LAi_jB IN , F I LBi_iB IN 
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TABLE A- 4 C Cent) 

File Modification Operations 


USE 

OPERATION 

OPTION 

S , Segment + 

(YA) 

T, Transfer 


S , Segment + 

(YA) 

T, Transfer 


V, Verify 

CA) , (B) 


EXAMPLE 


$ S i_iTAGA , TAGB , TAGC 

$ T i_jD T 1 i_j F I LA , F I LB , F I LC , F I LD i_i ( Y A ) ^ D T 2 i_jS O URC E 

$Si_iTAGA , TAGB , TAGC 

$TujPPi_j, , ,,_jCYA)^DT1i__iS0URCE 

$Vi_jDKi_jFILEA l_j(A) 
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Table A- 5 

File Transfer Operations 


PROCESS 

USE 

OPERATION 

OPTION 

EXAMPLE 

1) Transfer a file to the 
current UFD 

T, Transfer 

(A) or (B) 

$Ti_iDKi_iDESTFL DTli_jSOURCEt_j (A) 

2) Transfer a file to a 

selected noncurrent UFD 
when protection code 
permits 

T, Transfer 

(A) or (B) 
<UIC> 

$Tc_iDKi_j<JOE>DESTFL-^DTli_iSOURCEu(A) 

3) Transfer a file from a 
current UFD to a specified 
noncurrent unprotected UFD 

4) Transfer file and: 

T, Transfer 

(A) or (B) 
<UIC> 

$Ti_iDKi_j< JOE>DESTFL^DKu«jSOURCE i_j(A) 

a) Convert spaces to tabs 

T, Transfer 

(C) or (CA) only 

$Ti-jTT^DT1i>jS0URCE i_j ( CA) 

b) Convert tabs to spaces 

T, Transfer 

(E) or (EA) only 

$TL_iTT^-DTlt_jSOURCEi-_i (EA) 

c) Enable parity or 

checksum error to be 
detected 

T, Transfer 

(G) or (GA) only 

$Ti_jDT1i_j-<-DT2i_jS0URCEi_j (GA) 

d) Initialize the direc- 

tory of a mass storage 
device 

T, Transfer 

(N) or (NA) or 
(NB) 

$Ti_i DT 1 i-jDESTFL-<-DT 2i_i S OURCE i_i ( NA) 

e) Initialize or create 

a UFD for the current 
UIC 

T, Transfer 

(N) or(NA) or 
(NB) 

$ T DK i_jDE S T F L -t-DT li-J S OU RCE i_j ( NA ) 

f) Combine two or more 

files into one file 

T, Transfer 

(W) or (WA) or 
(WB) 

$Ti_iDKi_iDESTFL^DT2i_jA, B, Ci__i(WA) 
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TABLE A-6 
COPY OPERATIONS 


PROCESS 

USE OPERATION 

OPTION 

EXAMPLE 

1) 

Copy the contents of a 
specific device storage 
block 

B, 

Block 

copy 

None 

$Bi_iDTli_i5j2f , 51^DT2i_ilj2fl , 1^2 

2) 

Copy the contents of a 
specific series (i.e., 
range) of device storage 
blocks 

B, 

Block 

copy 

None 

$Bi_jDTli_i 5 j? , 5 5^DT2 i_ilj3fj2f , 1J?5 

3) 

Copy the contents of one 
or more blocks and: 







a) initialize the 
directory of the 
destination device 

B, 

Block 

copy 

CN) 

$Bi_jDTli_j5i2f-55t_j (N) ^DT2t_ilj2fpf-1^5 


b) initialize the 

directory and re- 
serve a iQSAVE area 
equal to core size 

B f 

Block 

copy 

CS) 

$Bi_jDTli_i5 , 6 , 7 t-i CS-) 4-DT2l_j50 , 5 1 , 52 


c) initialize direc- 
tory and specify 
size of IQSAVE area 
to be reserved 

B, 

Block 

copy 

CSnn) 

$Bi_iDTl i_i5 , 6 , 7 i_j CS 3 2 ) ^ DT2i_j 5)2f , 5 1 , 5 2 

4) 

Add (copy) the files on 
one device to those of a 
second device 

c, 

Copy 


None 

$Ci_jDK<-DT1 

5) 

Copy and add files from 
one device to another 
device and: 







a) initialize the direc- 
tory of the destina- 
tion device 

c. 

Copy 


(N) 

$Ci_iDKi__iCN)^DTl 


b) initialize the des- 
tination device direc- 
tory and reserve a 
core-sized iQAREA 

c. 

Copy 


CS) 

$Ci_jDT1v_jCS)^DK 
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TABLE A-6 CCont.) 
Copy Operations 


PROCESS 

USE OPERATION 

OPTION 

EXAMPLE 


c) initialize the 
directory and 
specify size of 
IQAREA 

c, 

Copy 

CSnnI 

$Ci__iDTl uj CS 3 2 1^ DK 

CS) is not permitted for disk 

6) 

Copy entire contents of 
a device onto another 
device. The contents 
of the source device to 
replace completely that 
of the destination 
device . 

c, 

Copy 

CHI 

$Ci_jDTl i_jCH1^DT2 

7) 

Copy a paper tape 

T, 

Transfer 

Cl) 

$Ti_jPPi_jCD^PR 
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Printed Message 

Interpretation 

ILL TERMINATOR 

Command improperly terminated: only RETURN 

or ALT MODE are legal. 

DEVICE NOT IN + . DAT 

Return to the monitor and use the A (Assign) 
command to assign the device involved to a 
positive .DAT slot. 

DEV ILL FOR OPTION 
FUNCTION 

Change function or device. 

FILE NAME TOO LONG 

Filenames are restricted to a maximum of 6 


characters plus a 3-character extension: 
the user has exceeded this limit. 

ILL SWITCH 

An optional switch entered in the command 
is not permitted in the primary operation 
being performed. 

SWITCH CONFLICT 

The combination of optional switches in 
the command string is illegal. 

NEED DATA MODE 

User must enter the proper data mode switch. 

CHKSUM ERR 

An error has occurred in the transfer of data; 
retry transfer. 

PARITY ERR 

File being processed contains a parity error. 
During T, transfer operation, this message 
may be accompanied by a printout of the line 
which contains the error. The user must 


Correct the indicated line (Use (G) switch 
in a Transfer, T, operation or the Editor) . 

S FUNCTION NOT DONE 

A segmentation operation requires the entry 
of an S command followed by a T command. 
This message indicates the S command was 
not entered. 

TOO FEW FILES 

These error messages indicate that the number 
of files on the destination side of the com- 

TOO MANY FILES 

mand does not match the number given on the 
source side. 

INPUT LINE TOO LONG 

Input commands are limited to one physical 
line of 72 characters; the user has attempt- 
ed to exceed this limitation. 

READ-COMP ERR ON 

During H mode or Block (B) copy operations. 

BLK:XXXXX 

PIP compares the newly written data blocks 
against the original blocks and outputs 
this message if they are different. 

FILE ALREADY PRESENT 

File under the 'new file name and extension', 
in a 'R' function, is already present on the 


device. 
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table a- 7 (Cont.) 
PIP Error Messages 


Printed Message 

Interpretation 

ILL BLK # 

Improper block number (i.e., too large, or 
negative) specified in command. 

STRINGS 1-16 ACCEPTED 

If a Segment, S, operation divides a file 
into more than 16 segments, PIP will load 
segments 1-15 to their respective destina- 
tion files. All remaining segments are put 
into the 16th file and this message is 
printed. 

ILL FUNCTION FOR UIC 

The operation specified is not permitted at 
the level of the current user. For example, 
a standard user (UIC) cannot employ the (R) 
switch in a copy to system device operation. 

UIC NOT IN MFD 

Indicates that a File Directory (UFD) has 
not been established for the current user. 
The user should employ the PIP, N, command 
to set up a UFD under his identification 
code (i.e. , UIC) . 

ILL UIC 

User has given an improper code; the UIC 
must be a 3-character code within angle 
brackets (i.e., <XXX>) . 

NEED BLK # 

No block number was given in an UPDATE com- 
mand; enter required octal number. 

P VIOLATION 

Current user has attempted an operation 
which violates the established protection 
code of a UFD or a file. 

ILL P CODE 

Specified directory code is illegal (i.e., 
something other than j? or 1) or the direc- 
tory just read has an illegal protection 
code) . 

SYSBLK NOT ON DEV 

Device specified is not the system device. 

DISK FULL 

Device has no further storage available. 

ILL CNT 

This error message is printed only in DEC- 
tape Directory listings. When output, it 
will appear immediately after the direc- 
tory line "SYSTEM BLKS" (for example: 

SYSTEM BLKS ILL CNT) . This message indi- 
cates that an illegal number of system 
blocks have been detected. The user, on 
detection of this error message, should 
immediately attempt to transfer any files 
contained by the DECtape involved onto 
another DECtape. The files should be trans- 
ferred one at a time. The faulty DECtape 
should be initialized to clear the error 
condition . 

ILL UFD ENTRY SIZE 

The size of an entry (i.e., filename or UFD) 

02T 

in the directory involved is illegal. This 

ILL MFD ENTRY SIZE 

error indicates that the system is faulty. 
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TABLE A- 7 (Cent.) 
PIP Error Messages 


Printed Message 

Interpretation 

NULL FILE NAME ILL 

A filename must be specified; a Null-name 
is not acceptable. 

ILL CMD STRUCTURE 

The command string entered was not properly 
ordered or structured. 

FILE STRUCTURE CONTAM- 
INATED 

The file structure on the device (i.e., 
disk) is faulty; this error indicates that 
the system is faulty. 

COMMAND STRING TOO 
LONG 

The command string entered exceeds 72 
characters . 

TOO MANY FILES OR 
BLOCKS 

The limit of 28^^ was exceeded. 

ILL FUNCTION 

The function specified in the command 
string entered (i.e., first character) is 
not a legal PIP function. 

ILL DEV/UNIT 

Illegal device mnemonic specified in command 
string. 

WARNING: BLOCK 
OCCUPIED 

Message output during update operations; it 
indicates that the user has not deleted the 
file which contains the bad block (# given 
by system) , The user should delete the file 
involved and reissue the update operation. 

FILE NOT ON 
INPUT DEVICE 

There is no file under the specified name 
on the directoried input device. 
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INDEX 


Abort operation, 7-2, 7-5 
Accounting file, 4-18, 4-20 
$ADD command, 6-4 
Address field, 5-8 
Alphabetic characters on punched 
cards, 2-1 
ALT MODE, 2-2 
Ampersand (&) usage, 8-7 
Argument field, 5-4 
ASCII file output, 6-40 
ASCII/Hollerith correspondence, 
2-2 

$ASG command, 4-11, 4-14, 6-5 
Assembly errors, 4-5, 4-7 
@ (at) signs used as delimiters, 
8-6 


Back-arrow (-«-) delimiter, 5-11, 
5-12 

Back-arrow (■«-) in Hollerith code, 
2-2 

BANK mode, 6-10 
BATCH system, 1-1, 1-3 
control language, 5-3 
operation, 7-7 

Beginning of user's job, 6-27 
Binary library files, 4-9 
Binary object program, 4-5, 4-7 
Block card columns, 5-4 
$BNK command, 6-10 
Bootstrap, 7-1 
BOSS preprocessor, 4-9 
BOSS XVM 

concepts, 4-10 
description, 1-3 
operation, 7-2 
B.PRE, 4-9 
Braces ( { } ) , 5-5 
$BUF command, 6-11 
Buffer pool, 4-17 
Buffers, 6-11 


Card 

code, 2-1 
commands, 2-3 
conventions, 2-1 
deck, 4-10 
reader, 7-2 

Card-position identifier, 8-6 
Cards , 

continuation, 5-24 
control, 8-6 
end of deck, 5-25 
end of file, 1-3 


CHAINTEST , 

job deck, 7-15 
job example, 7-10 
CHAIN utility program, 4-5, 4-8, 
5-18 

Characters, punctuation, 5-4 
$CHN command, 6-12 
$CMP command, 6-13 
Command 

field, 5-4, 5-7 
functions, 6-2 
language, 5-1 
syntax, 5-3 
Commands , 
card, 2-3 
control, 6-1 

Compare two source programs, 6-13 
Console log for program examples, 
7-11 

Continuation card, 5-24 
Control card, 8-6 
Control card format, 5-5 
Control commands, 6-1 
Core dump, 6-52 
Create ADD files, 6-15 
Create a file, 6-22 
$CRT command, 6-15 


Data modes, 5-18 
switches, 5-19 
.DAT slots, 4-11, 4-16 
DAT/UFDT slot assignments, 6-29 
Default string, 8-7 
Default value, 6-11 
Delete command, 5-21 
Delimiters, 5-4, 5-5, 5-6, 8-6 
in PIP commands, 5-14 
Device Assignment Table, 4-11, 6- 
see also DAT 

Device designations, 5-9 
Device handlers, 5-9 
Digits on punched cards, 2-1 
$DIR command, 6-16 
Directory output, 6-16 
Direct Substitution, 5-10 
Direct substitution control cards 
8-8 

Direct substitution procedure 
file, 8-7 

Disable XVM mode, enable and, 

6-55 

Disk cartridge, 4-17 

Disk file blocks, 4-15 

Disk file structure, 4-11, 4-12 

Disk handlers, 4-17 

Disk operating system, 1-1 
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Disk pack, 4-17 
$DLG command, 6-17 
$DMP command, 6-18 
$ (dollar) symbol in BOSS PIP 
commands, 5-12 
$DOS command, 6-20 
Dual operating environments, 1-1 
DUMP commands, 6-18 
Dump core, 6-52 
DUMP XVM program, 4-9 


Editing operation, 5-22 
Enable and disable XVM mode, 
6-55 

$END command, 6-21 
End of deck card, 5-25 
End-of-File, 2-2 
End-of-File card, 1-3 
Error codes, 4-5, 4-7 
Error messages, lOPS, 7-4 
Error processing, 4-18 
Errors, punch card, 7-2 
Examples 

of batch operation, 7-7 

of procedure file, 8-8 
Execute absolute file, 6-54 
EXECUTE XVM program, 4-8, 5-18 
Expanded substitution, 5-6 
Expanded substitution file, 5-5 


Field delimiters, 5-5, 5-6 

Field set, 5-4, 5-8 

$FIL command, 6-22 

File Directory (UFD) , 5-10 

File flow, 8-1 

File I/O status, 8-10 

File protection, 4-14 

File protection code, 6-51 

Files on disk, 4-15 

File structure, 4-11 

Fixed-length records, 4-17 

Floating point, 4-3 

$FOR command, 6-24 

FORTRAN IV compiler, 4-3, 6-24 


Global symbols, 4-5 


Hardware, 3-1 
optional, 3-2 
Hollerith cards, 2-1 


Input/Output 

code modules, 5-18 
file status, 8-10 
macros, 4-18, 4-19 
Insert command, 5-21 
lOPS error messages, 7-4, 7-6 


$JOB command, 6-27 
Job deck, 7-13 
Job listing, 7-12 


$KEP command, 6-29 


Languages, 4-1 
Language syntax, 5-1 
$LCM command, 6-30 
$LIB command, 6-33 
Libraries, 4-1 

Library file update, 4-9, 6-30 
Line editor, 4-9, 5-20, 5-22, 
6-7 

Line printer, 7-2 

Links, 4-8 

$LNK command, 6-35 

Load and execute programs, 4-8 

Load BOSS, 7-1 

$LOG command, 6-39 

Log messages, 7-3 

LOG-OUT current UIC, 6-17 

$LST command, 6-40 


MACll assembler, 4-5 

$MAC11 command, 6-41 

Macro definition records, 8-5 

Macros, 4-4, 4-6 

MACRO XVM assembler, 4-4, 6-7 

Magtape specification, 6-12 

$MAP command, 4-8, 6-43 

Mass storage devices, 4-9 

Master File Directory (MFD), 4-12, 

5- 10 

Messages to the operator, 6-46, 

7-3 

MFD, 4-12, 5-10 

$MIC command, 6-44 

Mnemonic symbols, 4-4 

$MNT command, 6-45 

Modes of data, 5-18 

Monitor Identification Code (MIC) , 

6- 44 
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Mount a specified tape, 6-45 
$MSG conunand, 6-46 
$MSW command, 6-47 


$NDR command, 6-48 
Nested variables, 8-7 
Non-resident Monitor, 4-17 


Object code, 4-5, 4-7, 5-17 
Object Time System (OTS) , 4-3 
Open a file, 4-17 
Operating environments, 7-8 
Operating procedures, 7-1 
Operator action, 7-3 
Operator messages, 7-3 
Optional hardware, 3-2 
Option field, 5-4, 5-8 
Output, ASCII file, 6-40 
Overlay files, 6-49 
Overlay structure, 6-35 
$OVL command, 4-8, 6-49 


$PAG command, 6-50 
PAGE mode, 6-50 
Parentheses, 8-7 
PIP (Peripheral Interchange 
Program) , 4-9 
commands, 5-3, 5-12 
command string formats, 5-11, 
A-2 

functions, 5-15 
primary operations, 5-15 
tables, A-1 

Preprocessor B.PRE, 5-23 
Print listing, 7-13 
Procedure file, 4-11, 5-4, 8-3 
example, 8-8 

Program control function example, 
7-10 

Program execution, 7-12 
example 7-7 

Protection codes, 4-14 
$PRT command, 4-14, 6-51 
Punched cards, 2-1 
errors, 7-2 

Punctuation characters, 5-4 


Random access, 4-17 
Records, 8-5 

Recursive instruction, 4-6 
Refresh a file directory, 6-48 
Reserved characters, 5-7 
Retrieval Information Block (RIB) 
4-15, 4-16 
$RUN command, 6-53 
Run-time file, 5-4, 8-1 


.SCOM registers, 4-17, 8-2 
Semicolon (;) used as delimiter, 
5-10 

SGEN XVM, 4-7 
Software environment, 4-1 
Source and object code, 5-17 
Source coding, 4-5, 4-7 
Source Compare Program (SRCCOM) , 
4-10, 6-13 

Source control records, 8-5 
Source programs, 4-1 
Special characters, 2-2 
Special function commands, 5-3 
Spooling, 7-1 

Square brackets ( [ ] ) , 5-5 

SRCCOM program, 4-10, 6-13 

Substitutions, 5-22 

Symbols, 4-7 

Syntax, command, 5-3 

System features, 1-3 

System generator, XVM/DOS , 4-7 

System hardware, 3-1 

System operation, 7-2 

System program load commands, 5-3 


Tables, A-1 

TERMINAL ERROR message, 7-5 
Terminal errors (lOPS) , 7-6 


UFDT, 4-16 

UPDATE program, 4-9, 6-33 
User File Directory (UFD) , 4-12, 
4-13 

User File Directory Table (.UFDT) 
4-14 

User Identification Code (UIC) , 
4-12, 5-10, 6-39 
User Identification Field, 5-9 


$QDP command, 6-52 
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Wait for operator, 6-47 


$XCT command, 4-8, 6-54 
$XVM command, 6-55 
XVM/DOS system generator, 4-7 
XVM mode, 6-55 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the softw’are described in this m.anual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

I I Assembly language programmer 
I I Higher-level language programmer 
I I Occasional programmer (experienced) 

I I User with little programming experience 
I I Student programmer 

I I Non-programmer interested in computer concepts and capabilities 

Name Date 

Organization 

Street — 

City State Zip Code 

or 

Country 
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